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The RT-11 (Real Time-11) computer system is a single-user 
computer/operating system that serves the programming needs 
of both the beginning and the advanced programmer. RT-11 
supports a number of programming languages, including in- 
dustry-standard FORTRAN and BASIC: and — for more ad- 
vanced users — the PDP-11 assembly language, MACRO-11. 
RT-11 also provides a comprehensive set of operating com- 
mands for controlling system operations. 



PREFACE 



The purpose of this introductory manual is to acquaint you with 
a number of RT-11 operating commands that are used to per- 
form common system operations. The manual first presents in- 
formation that you need to understand a particular system op- 
eration; then it shows you how to apply the system operation in 
a series of operating commands and exercises that you re- 
create; finally, it provides a list of reference materials that con- 
tain more information about the operation. This approach 
makes it possible for you to learn quickly the major features of 
the system; at the same time, it eliminates many of the 
learning problems encountered by new users. 

This manual describes system usage fundamentals. It is not the 
intent of this manual to teach you to program the PDP-11 com- 
puter. You may already be proficient in one or more of the 
available programming languages. Likewise, no attempt has 
been made in this manual to cover all the possible applications 
for which the RT-11 computer system is suited. You will dis- 
cover many applications yourself as you continue to use the 
system. 



MANUAL INTENT 



This manual is designed for three categories of RT-11 users: 

® Inexperienced users: Those having little or no previous 
"hands-on" computer experience (including those whose expe- 
rience has been limited to batch environments) 

® Experienced users: Those who are experienced users of a 
com-puter system other than the RT-11 computer system 

9 Experienced RT-11 users: Those who have used previous 
versions of the RT-11 computer system but wish a quick in- 
troduction to the newest features of the current system (Ver- 
sion 5) 

The manual contains 17 chapters and 2 appendixes. The de- 
scriptions that follow and the chart at the end of this section 
will help you determine your own reading path. 



MANUAL DESIGN 



IX 



Preface 



Chapter 1, Introducing the RT-11 Computer System, discusses 
general system concepts. It introduces the roles of hardware 
and software in a computer system and describes the specific 
hardware and software components of the RT— 11 computer 
system. Chapter 1 is intended for users in the first two catego- 
ries. 

Chapter 2, Starting the RT-11 Computer System, shows all 
users how to start the system. 

Chapter 3, Interacting with the RT-11 Computer System, dem- 
onstrates how you use the console terminal to control system 
operations. Again, this chapter is most helpful to users in the 
first two categories. 

Chapters 4 through 7 describe system operations that are 
useful to all categories of users. Each chapter begins with a 
textual explanation of a particular system operation and ex- 
pands into computer demonstrations showing the operation in 
use. Topics covered are: Using the Monitor Command Lan- 
guage; Creating and Editing Text Files; Comparing Text Files; 
and Performing File Maintenance Operations. Experienced 
RT-11 users may prefer to skip the textual explanations and 
review only the computer exercises. 

Chapter 8, Choosing a Programming Language, helps you 
determine which language to use. Choose BASIC-11, 
FORTRAN IV, MACRO-11, or a combination of these three 
languages to continue the exercises in this manual (BASIC-11 
and FORTRAN IV are optional products). 

Chapters 9, 10, and 11 describe the process of running pro- 
grams written in the FORTRAN IV, BASIC-11, and 
MACRO-11 languages, respectively. You should read any 
chapters that apply to your choice of language. 

MACRO-11 and FORTRAN IV users should continue to 
Chapter 12, Linking Object Programs, and Chapter 13, Con- 
structing Library Files. 

Chapter 14, Debugging a User Program, provides some sugges- 
tions for finding and fixing errors in user programs; all users 
should read this chapter. 

Chapter 15, Using the Foreground/Background Monitor, is in- 
tended for users who plan to exercise the foreground/back- 
ground capability of the RT-11 system. 

All users should continue to Chapter 16, Using Indirect Files. 
Indirect files allow the system to perform operations unat- 
tended. 
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Chapter 17 gives some advice to new users and includes a de- 
scription of the RT-11 HELP file. 

Two appendixes are provided for reference. Appendix A 
discusses manual bootstrapping procedures and Appendix B 
provides some additional information on selected system usage. 

A glossary of technical terms appears at the end of the manual 
for reference purposes. 

The following flowchart will help you plan your reading path 
through the manual. Read the chart from top to bottom; answer 
the questions and follow the direction of the arrows to see 
which chapters you should read. 

NOTE 

The demonstration portions of this manual are for use 
with Version 5 and later releases of RT-11. The exer- 
cises are quite lengthy, and you may prefer not to com- 
plete them in one sitting. You may pause at the end of 
any individual chapter. It is recommended that you stop 
only at the end of a chapter since you will otherwise not 
complete an exercise and thus may introduce errors that 
will affect later exercises. Instructions for pausing and 
beginning again are given in Appendix B. 



XI 



Preface 



READ 
CHAPTER 10 



READ 
CHAPTER 14 




Put Versions of RT-11 



No Experience, or 
other systems 



READ CHAPTERS 
1,2 AND 3 



READ 
CHAPTERS 4 
THROUGH 8 




FORTRAN 



READ 
CHAPTER 9 



READ 

CHAPTERS 12 

AND 13 



READ 
CHAPTER 14 



READ 
CHAPTER 2 



MACRO 



READ 
CHAPTER 11 



READ 

CHAPTERS 12 

AND 13 



READ 
CHAPTER 14 



DO 
YOU WANT ' 
_Y«LX^TO USE ANOTHER \ N° 
PROGRAMMING 



READ 
CHAPTER IS 



Yes 




-t^ USING F/B 
? 



No' ' 



READ CHAPTERS 
16 and 17 



{ DONE J 



Figure 1 Flowchart for Selective Reading 



Xll 



CHAPTER 1 
INTRODUCING THE RT-11 COMPUTER SYSTEM 



A computer system is a collection of components that work to- 
gether to process data. The purpose of a computer system is to 
make it as easy as possible for you to use a computer to solve 
problems. A functioning computer system combines hardware 
elements with software elements. The hardware elements are 
the mechanical devices in the system, the machinery and the 
electronics that perform physical functions. The software ele- 
ments are the programs written for the system; these programs 
perform logical and mathematical operations and provide a 
means for you to control the system. Documentation includes 
the manuals and listings that tell you how to use the hardware 
and software. Collectively, these components provide a com- 
plete computer system that allows both layman and expert 
alike to use a computer.^ 

SYSTEM HARDWARE 
SYSTEM SOFTWARE 
+ SYSTEM DOCUMENTATION 



COMPUTER SYSTEM 



The RT-11 computer system requires three basic hardware 
items: the computer, which performs all data processing; a ter- 
minal device, used like a typewriter for two-way communica- 
tion between the user and the system; and a storage medium, 
for storing programs and data. Figure 1-1 illustrates the hard- 
ware components of a typical RT-11 computer system. 



SYSTEM 
HARDWARE 



The computer performs all instruction decoding and data pro- 
cessing. The RT-11 computer system, is constructed around a 
DIGITAL PDP-11 computer, several of which are shown in 
Figure 1-2. Any model of PDP-11 can be used in an RT-11 
system. 

Notice in Figure 1-2 that the front panel, or operator's console, 
of each PDP— 11 computer is slightly different. The switches, 

Vmtfnno anrl licrVifa tViof qvq r\rt i-\\a /-ii-><-v».r.4-/-v».'r^ ^^-^^^1^ „~.« 1 

for various kinds of computer operations and applications. In 
the RT-11 computer system they are used only to start the 
system. Once the system has been started, your interaction 
with the computer system occurs through the terminal. 



This chapter attempts to build a working vocabulary that is both meaningful 
to the new user and consistent with standard DIGITAL terminology. Some 
definitions may appear inconsistent with those you have previously learned 
or used. 



The Computer 
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Figure 1-1 RT-11 Computer System 
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Figure 1-2 PDP-11 Computers 



The terminal allows two-way communication between you (the 
user) and the computer system. You enter information — opera- 
ting commands, for example — from the terminal keyboard, 
which is operated much like a typewriter keyboard. The com- 
puter, in turn, prints information and messages on the ter- 
minal's printer or screen. Figure 1-3 shows two terminal 
devices — the VTIOO video terminal and the LA120 hardcopy 
terminal — that can be used in an RT-11 computer system. 



The Terminal 
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Figure 1-3 Terminal Devices 

Generally, an RT-11 computer system has only one terminal 
through which all system/user interaction takes place. This is 
called the console terminal. If the system has more than one 
terminal, one of them is still designated the console terminal; 
others simply provide auxiliary message-printing capabilities. 



The Storage 
Medium 



The third important hardware device in an RT-11 computer 
system is the storage medium (usually a disk). It stores pro- 
grams — those that make up the computer system software and 
those that you create. It serves as a distribution medium; 
system software is often packaged and distributed on a disk by 
the system supplier. Finally, it stores other data, information 
that is eventually needed for a computer operation (called 
input), the results of a computer operation (called output), or 
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textual information such as a report. Figure 1-4 shows the 
random-access storage media (and their specific drive units) 
that can be used in an RT-11 computer system. (Random access 
means that access time for data is independent of the location of 
data. Contrast this concept with sequential access.) 
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Figure 1-4 Random-Access Storage Media 
and Their Devices 
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These three devices — the computer, the terminal, and the 
storage medium — are the required hardware components of an 
RT-11 computer system. With the exception of the computer, 
all hardware devices are called peripheral devices. Peripheral 
devices supplement the computer by providing external re- 
sources for operations that the computer cannot handle alone. 
In addition to the terminal and storage medium (which are re- 
quired peripheral devices), other peripheral devices can be used 
in an RT-11 computer system. 



Optional Devices Optional peripheral devices are added to a computer system 

according to the specific needs of the system users. For ex- 
ample, computer systems that are used primarily for program 
development may have extra storage devices and a high-speed 
printing device. Computer systems used in a laboratory envi- 
ronment may have graphics display hardware, an oscilloscope 
device, and an analog-to-digital converter. Computer systems 
that provide (or use) information in conjunction with another 
kind of computer system usually have a magtape device, be- 
cause magtape is an industry-standard storage device. 

Peripheral devices are categorized as input/output (I/O) devices 
since the functions they perform provide information (input) to 
the computer, accept information (output) from the computer, 
or do both. Line printers are output devices because they per- 
form only output operations. Terminals and storage devices are 
input/output devices because they perform both input and 
output operations. Figure 1-5 shows several of the optional pe- 
ripheral devices that are often added to an RT-11 computer 
system. 




VTll Display 
Figure 1-5 Peripheral Devices 



1-6 



Introducing the RT-11 Computer System 



VLLlJin 



©J 



■' - - . ^ i 
,-. . ■'■■■.■■ ) 



Magtape 



Line Printer 





-^7 . 

Figure 1-5 Peripheral Devices (Cont.) 



The hardware configuration of your own RT-11 computer 
system includes the computer, the terminal, the storage me- 
dium, and any other peripheral devices you choose to add. 



System software is an organized set of supplied programs that 
effectively transform the system hardware components into us- 
able tools. These programs include operations, functions, and 
routines that make it easier for you to use the hardware to 
solve problems and produce results. For example, some system 
programs store and retrieve data among the various peripheral 
devices. Others perform difficult or lengthy mathematical cal- 
culations. Some programs allow you to create, edit, and process 
application programs of your own. Still others handle entire 
applications for you. 

As illustrated in Figure 1-6, system software always includes 
an operating system, which is the "intelligence" of the com- 
puter system. Usually the system software includes one or sev- 
eral language processors; it sometimes also includes specific ap- 

■r\\ 1 /*o 4-1 r\irk ci 
I./X J. vci uiv/i.xo . 



SYSTEM 
SOFTWARE 
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Figure 1-6 System Software 



The RT-11 
Operating System 



An operating system is a collection of programs that provides 
an environment in which you can create and run programs of 
your own. The operating system organizes all the hardware and 
software resources of the computer system into a working unit 
and gives you control. 

The RT-11 operating system comprises four types of programs: 
a monitor/executive program for system control and supervi- 
sion; several device handlers (programs), one for each of the 
supported hardware devices; a variety of utility programs for 
program/data creation and manipulation; and finally, the inter- 
faces that are necessary to support several programming lan- 
guage processors. The operating system is illustrated in Figure 
1-7. 

The monitor (executive) program is the link between the 
system hardware, the system software, and you. Part of the 
monitor function is to accept, process, and execute your instruc- 
tions for controlling the system. A comprehensive set of monitor 
operating commands allows you to direct, from the console ter- 
minal keyboard, those system operations that you want to 
occur. 

Device handlers are routines that provide the interface to the 
various hardware devices that are part of the computer system. 
A handler exists for every peripheral device that the system 
supports. 

Utility programs cover a wide range of resources; such pro- 
grams allow you to create and edit text, maintain other pro- 



1-8 



Introducing the RT-11 Computer System 




Figure 1-7 The RT-11 Operating System 

grams, and locate user-programming errors. Some utility pro- 
grams in the RT-11 operating system are the following: 

9 An editor, which allows you to create and modify textual ma- 
terial; this material could be the statements that make up a 
computer program, a memo, or any text you wish to create 

® File maintenance utility programs, which allow you to manip- 
ulate and maintain your programs and data '— to transfer 
them between devices, to update them, and to delete them 
when you are done with them 

9 A debugging program, which helps you uncover and correct 
errors in your programs 

9 A librarian, which makes it easy for you to store and retrieve 
often-used programming routines 

9 A linking program, which converts object modules into a 
format suitable for loading and execution 

® A source comparison program, which is used to compare two 
ASCII files and to output any differences to a specified output 
device 

® A dump program, which outputs to the console or line printer 
all or any part of a file in octal words, octal bytes, ASCII 
characters, or Radix-50 characters 

The RT-11 operating system also provides support for several 
programming languages and their respective language proces- 
sors. 
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A language processor is a translating program that you use to 
process a source program you have created. A language pro- 
cessor exists for every programming language supported by the 
system, whether it is a high-level language or a machine-level 
language.^ 

High-level languages, such as BASIC-11 and FORTRAN IV, 
are relatively easy languages to learn and use. Since a single 
language statement often performs a series of intricate com- 
puter operations, high-level languages let you direct your at- 
tention to solving the problem at hand. They do not require 
that you understand how the computer interprets the problem. 
In addition to FORTRAN IV and BASIC-11, the RT-11 opera- 
ting system supports the high-level language DIBOL, DIG- 
ITAL'S interactive commercial language. 

Machine-level or assembly languages are available for users 
who prefer to work at the instruction level of the computer. At 
this level, you have control over such factors as program size 
and speed of execution. Machine-level languages do require 
that you be familiar with the computer and the hardware de- 
vices of the system. RT-11 provides the MACRO-11 assembly 
language processor for those who would rather work at this 
more intricate level. 



Applications 
Packages 



The RT-11 operating system supports several applications 
packages. These include a laboratory applications package for 
the standard functions found in most laboratory environments. 
A scientific subroutine package (for FORTRAN IV users) pro- 
vides a large selection of mathematical and statistical routines 
commonly required in scientific programming. And a graphics 
support package for BASIC-11 and FORTRAN IV users pro- 
vides display features such as multiple intensity and blinking 
vectors (lines), alphanumerics, and points. Because of the spe- 
cialized nature of these applications packages, they are not de- 
scribed further in this manual. 



SYSTEfM 
DOCUMENTATION 



The third component of a computer system is documentation, 
which includes manuals that tell you how to use the software 
and hardware of the computer system. Documentation also in- 
cludes any source listings of programs that make up the opera- 
ting system. 



Hardware Manuals 



Hardware manuals describe the devices in the computer 
system. RT-11 hardware documentation includes a Processor 



^Language selection is discussed in Chapter 8 of this manual. 
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Handbook that describes the PDP-11 computer you are using, 
and a User's Guide or Maintenance Manual for each peripheral 
device in your computer system. These manuals tell you how to 
operate the devices and give you special programming informa- 
tion that you may need if you intend to write device drivers or 
special system software involving the devices. 



Software manuals^ describe the operating system and the lan- 
guage processors. RT-11 software documentation falls into 
three major categories: introductory or once-only manuals (in- 
tended to be used once and then stored away); console manuals 
(intended to be used at the computer); and desk/console man- 
uals (intended to be used at your desk for reference purposes). 

Once-only manuals include this manual and others that are 
needed only when your system is initially installed. You may 
have little or no occasion to use these manuals once your com- 
puter system is in operation and you are familiar with its use. 

Console manuals are those manuals that tell you how to use the 
computer system. They describe in detail command usage and 
syntax, list summaries of system operations, and give the 
meanings of system messages. The RT-11 System User's Guide 
is an example of a console manual. 

Desk/console manuals are those manuals that you continually 
use for reference as you write your own application programs. 
These manuals include the general language reference man- 
uals and the advanced programming manuals that contain pro- 
gramming information specific to the RT-11 computer system. 
The RT-11 Software Support Manual is an example of a 
desk/console manual. 



Software Manuals 



Source listings are actual listings of the assembly language 
code that makes up the RT-11 operating system. These listings 
are very detailed and are generally needed only if you intend to 
modify the system software. They can be ordered on microfiche 
from the DIGITAL Software Distribution Center. 

This completes a general introduction to the RT-11 computer 
system. Subsequent chapters of this manual describe how you 
use i/iic various system components mentioned here to perform 
a series of related computer operations. You begin in Chapter 2 
by learning how to start the RT-11 computer system. 



Source Listings 



All RT-11-related software manuals are listed and described in the Guide to 
RT-11 Documentation. Many of these manuals are provided with your sys- 
tem; others can be ordered from the DIGITAL Software Distribution Center. 
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CHAPTER 2 
STARTING THE RT-11 COMPUTER SYSTEM 



Before you can use the RT-11 computer system to perform any 
operations, you must start it. Starting the system involves 
turning on the computer and the various hardware devices and 
loading the appropriate software components into computer 
memory. 



Within every PDP-11 computer is a physical, designated COMPUTER 

storage area called memory. Computer memory is where MEMORY 

system information and data are temporarily loaded and stored 
for use during the various system operations. 

Each time you use the computer system, there may already be 
information in computer memory, left by the person who used 
the system last. For example, there may be the results or data 
of another user's program; there may be the results of a partic- 
ular system operation; there may even be an entirely different 
operating system in memory. For your purposes, computer 
memory must contain the RT-11 operating system, and specifi- 
cally the RT-11 monitor program. Thus, your first operation as 
a system user is to transfer the monitor program from the disk 
device, where it was stored during system installation, to com- 
puter memory, where you can use it. The process of transferring 
the RT-11 monitor to memory is called bootstrapping the 
system; it is the only system operation that requires you to use 
the operator's console on the front panel of the computer (see 
Figure 2-1). 



Starting the RT-11 computer system requires that you know HARDWARE 

how to operate your system's hardware devices. Since you may CONFIGURATION 

not have had the opportunity to use any of the devices yet, ask 
an experienced user to help you the first time. Follow the in- 

oux tAVyUJLVyjLio XXX u±±\^ owv/uxv/xx XXX uxxxo oxxCXL/UOX CJLXL'XL'XOU. XJKJ\J\jO\jl.Ci]j X XXJ" 

cedure." If necessary, refer to the RT-11 Automatic Installation 
Booklet, the RT—11 Installation Guide, or the various hardware 
manuals provided with your system. 

First read through the following material and fill in the appro- 
priate information where requested. You should be able to 
determine all responses by checking the RT-11 Automatic In- 
stallation Booklet or the RT-11 Installation Guide. 
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Figure 2-1 Bootstrap/Computer Relationship 



NOTE 

If your system device is a diskette, you need to build four 
volumes and, when running some of the demonstration 
programs, limit the volumes to the components needed 
to execute the programs. Also, you need to preserve the 
distribution volume you received from DIGITAL by 
making backup copies. The RT-1 1 automatic installation 
procedure performs these functions for you. If you did 
not use the automatic installation procedure to install 
your RT-11 system, the RT-11 Installation Guide will 
provide you with the commands you need to copy and 
preserve the distribution volume and create the volumes 
for use with this manual. 

You must have the following materials to start the system and 
to perform the exercises in this manual: 

9 The volume containing the RT-11 operating system (called 
the system volume); refer to Section 2.3.6 of the RT-11 Instal- 
lation Guide for the list of components you will need on your 
system volume to perform the exercises 

« The volume containing the FORTRAN IV and/or BASIC-11 
language processors if these languages are not stored on the 
system volume (available only to FORTRAN IV and 
BASIC-11 users) 
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® A volume for program storage (for example, magtape or an- 
other disk or diskette); this volume should contain no im- 
portant information since all information on it will be erased 
during a later computer exercise 

® A copy of the RT-11 Automatic Installation Booklet or the 
RT-11 Installation Guide 

NOTE 

You can find hardware configuration information in tlie 
various hardware manuals provided with your system. 
Instructions for starting (bootstrapping) your RT-11 
system appear in the RT-11 Automatic Installation 
Booklet and the RT-11 Installation Guide. This informa- 
tion should be adequate for you to answer all the ques- 
tions asked here. If you have trouble, see Appendix B, 
Suggestions for Bootstrapping the System. Do not con- 
tinue to any other chapter in this manual until you under- 
stand the following configuration information and can 
bootstrap the system yourself. 



1. What kind of terminal device are you using (for example, Terminal 

LA120 DECwriter ni, VTIOO video terminal)? 



2. Is your computer a PDP-11/23-PLUS, PDP-11/24, or Computer 
PDP-11/44? 

3. Does your computer operator's console have pushbuttons or 
switches? 

4. How much memory does your computer have? 



5. What kind of system volume are you using (for example, Syst®m Volume 
RL02 disk, RX02 diskette)? / 

6. What is the two-letter mnemonic for this volume (typical 
mnemonics are given in Table 2-1; respond with the mne- 
monic for your own volume)? 
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Table 2-1 Representative System Volumes 



Volume 


Mnemonic 


RD50/RD51 Disk (PC350) 


DW 


RXOl Diskette 


DX 


RX02 Diskette 


DY 


RX50 Diskette (PC325/PC350) 


DZ 


RK05 Disk 


RK* 


RK06/07 Disk 


DM 


RC25/RD51 Disk, RX50 Diskette 


DU 


RLOl/02 Disk 


DL 



*Use DK to bootstrap from an RK05 disk. 



Storage Volume 



7. What volume are you using for program storage (for ex- 
ample, TSll magtape, RL02 disk)? 

8. In which device unit will you use this volume (choose any 
available device unit — for example, 0, 1)? 



Optional Devices 
and Supported 
Languages 



9. What peripheral devices are part of your system (for ex- 
ample, line printer, magtape, VTll display hardware; list 
all devices other than the terminal and the computer)? 

10. What programming languages does your system support 
(MACRO-11 or BASIC-11, for example)? 



BOOTSTRAP 
PROCEDURE 



Once you have determined your hardware configuration, you 
are ready to bootstrap the system. The purpose of the bootstrap 
procedure is to load and start the RT-11 monitor in computer 
memory, thus activating the RT-11 computer system for your 
use. 

NOTE 

If your answer to question 2 in the Hardware Configura- 
tion section is YES, continue to the next paragraph. Oth- 
erwise, read the section entitled Bootstrapping the 
System, in Appendix A, for bootstrap instructions. 

The bootstrapping procedure for the RT-11 computer system on 
a PDP-11/23-PLUS, PDP-11/24, or PDP-11/44 processor con- 
sists of the following steps. For more detailed instructions on 



Version 5.1, July 1984 
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the bootstrap operation, refer to the RT-11 Automatic Installa- 
tion Booklet. 

1. Turn the terminal to an on-line condition. 

2. Make sure that the computer power is on and that the com- 
puter is not already in use. 

9 If your computer is a PDP-11/23-PLUS, power up the 
system by lifting the AUX toggle switch to the ON posi- 
tion. The red PWR OK indicator on the front panel will 
light up if the system was successfully turned on. 

9 If your computer is a PDP-11/24 or a PDP-11/44, power 
up the system by turning the status selector key to the 
LOCAL position. The red DC ON indicator on the front 
panel will light up if the system was successfully turned 
on. 

3. Stop the computer. 

9 If your computer is a PDP-11/23-PLUS, lift the HALT 
toggle switch to the up position. The AUX toggle switch 
that you lifted in the previous step and the HALT toggle 
switch can be lifted simultaneously. 

9 If your computer is a PDP-11/24 or a PDP-11/44, push 
the HALT/CONT/BOOT horizontal toggle switch to the 
HALT position. 

4. Load the system volume in its corresponding device unit 0. 
Make sure that the system volume is write-protected (for all 
except RXOl or RX02 diskettes, which are always write- 
enabled). 

5. Load the storage volume in the device unit noted in ques- 
tion 8 in the Hardware Configuration section. Make sure 
that this volume is write-enabled. 

6. Boot the system. 

9 If your computer is a PDP-11/23-PLUS, lift the RE- 
START toggle switch on the front control panel. This 
switch will not remain in the up position; it will spring 
back to the center position. 

® If von r r.nmniif.fir is n VTW—IMOA r>v q Pnia 11 /A A »>„^u 

— ./ jr — — _ -^^ ^^,^^ ._.x t^ J. j^a. — J.J./-X-X, pu.011 

the HALT/CONT/BOOT horizontal toggle switch to the 
BOOT position. This switch will not remain in the right- 
most position; it will spring back to the center position. 

The red RUN indicator on the front control panel should 
now be illuminated. 
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A series of self-diagnostic routines to check out the system are 
then executed. The execution of these routines may take up to a 
minute, depending upon how much memory is installed in your 
system. A prompt appears on your console terminal when exe- 
cution of the routines is completed. The prompt that appears is 
dependent upon the type of processor you are using. Table 2-2 
provides the prompts that appear and the corresponding re- 
sponses which must be supplied if you are using the 
PDP-11/23-PLUS, PDP-11/24, or PDP-11/44 processor. 

Table 2-2 Bootstrap Prompts and Responses 



Processor 




Prompt 


Response 


PDP-11/23- 


-PLUS 


TESTING MEMORY 

wwww.KW 

START? 


dd[n]® 


PDP-11/24 




bbbbbbbb 


<none> 


PDP-11/44 




>» 


B dd[n](RiT) 



wwww. = amount of memory in K- words (decimal) 

bbbbbbbb. = amount of memory in K-bytes (octal) 
dd[n] = device mnemonic (dd) and unit number (n) 



7. Respond to the prompt that appears on your, console ter- 
minal by typing the appropriate response (refer to Table 
2-2) followed by a carriage return. 

NOTE 

Refer to question 6 in tlie Hardware Configuration sec- 
tion for the two-letter device mnemonic (dd) and refer to 
question 8 for tfie device unit number (n). 

You should now direct your attention to the console terminal, 
since system interaction continues on this device. 



flEPERENCES PDP-11 Processor Handbook, Maynard, Mass.: Digital Equipment Corpora- 

tion, 1981. 

A hardware manual for the owners and users of the PDP-11 family of 
computers and for those who will be using the PDP-11 assembly lan- 
guage instruction set. 
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RT-11 Automatic Installation Booklet: RX02 Diskettes (AA-M235A-TC), 
RT-11 Automatic Installation Booklet: RL02 Disk (AA-M236A-TC), 
RT-11 Automatic Installation Booklet: RC25 Disk (AA-M237A-TC)' and 
RT-11 Automatic Installation Booklet: MICRO/PDP-11 (AA-M238A-TC). 
Maynard, Mass.: Digital Equipment Corporation, 1983. 

RT-11-specific software booklets which provide basic instructions for 
using the automatic installation process to install and test the RT-11 
monitors, system programs, and certain languages. 

RT-11 Installation Guide (AA-H376B-TC) and RT-11 System Release Notes 
(AA-5286E-TC). Maynard, Mass.: Digital Equipment Corporation, 1983. 

Two RT-11-specific software manuals that contain instructions for in- 
stalling, customizing, and starting the RT-11 computer system. 

RX8/RX11 Floppy Disk System Maintenance Manual 
(EK-ORX01-MM-PRE2). Maynard, Mass.: Digital Equipment Corporation, 
1975. 

A hardware manual for the owners and operators of RXOl diskettes and 
for those who will be programming computers to interact with these 
devices. 

VTIOO User Guide (EK-VT100-UG^002). Maynard, Mass.: Digital Equip- 
ment Corporation, 1978. 

A manual for the owners and operators of the VTIOO video terminal and 
for those who will be programming computers to interact with these 
devices. 
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CHAPTER 3 
INTERACTING WITH THE RT-11 COMPUTER SYSTEM 



Interaction with the RT-11 computer system involves an ex- 
change of information between you (the user) and the software 
operating system. The exchange may be active, with you dic- 
tating command information from the terminal keyboard and 
the system responding immediately; or it may involve the 
storing of information on mass storage volumes for later use. 



During the bootstrap procedure you activated the RT-11 com- 
puter system by loading and starting the monitor program in 
computer memory. One of the functions of the monitor program 
is to provide you with the capability to use the console ter- 
minal. Since the console terminal can perform both input and 
output operations, it is used to interface between the system 
and the user. With it, you can: 

» Type the commands that control system operation 
9 Receive messages and responses from the system 

All console terminals have a keyboard — used to enter informa- 
tion — and a paper output device or video screen — used to echo 
characters typed at the keyboard and to print system messages 
and responses. Figure 3-1 shows two commonly used terminals, 
the LA120 and the VTIOO. 

These two terminals differ in their output mechanism. While 
the LA120 terminal has a paper printer, the VTIOO has a video 
screen. The paper printer and the screen serve the same pur- 
pose — they show user input and system responses; however, 
paper output can be saved for later use .while screen output is 
temporary. The keyboards of both terminals are shown in Fig- 
wce 3-2. 



USING THE 

CONSOLE 

TERMINAL TO 

EXCHANGE 
INFORMATION 
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VTIOO 



Figure 3-2 LA120/VT100 Keyboard Layouts 



Using Figure 3-2 as a guide, study your own terminal key- 
board. First, notice that the keys for the alphabetic characters 
are positioned in the same way as on most standard typewrit- 
ers. The SHIFT key allows you to select between numeric and 
special characters and between uppercase and lowercase 
characters.^ The position of the numeric and special characters 
varies somewhat among the different terminals, so you may 
need to hunt for a particular key until you become familiar 
with your own terminal. 

Locate the DELETE key. This key is used to correct a tjrping 
mistake. Pressing the key once cancels the last character typed. 
Pressing it twice cancels the last two characters, and so on, 
back to the beginning of the line. 



^With the exception of system messages and one other exception explained in 
Chapter 5, the RT-11 computer system uses uppercase characters exclusively. 
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Locate the TAB key. Tab stops on a computer terminal are 
positioned every eight spaces across the Hne, beginning at 
column 1. Pressing the TAB key moves the character pointer 
(that is, the position on the line where the next character will 
be typed) to the beginning of the next tab stop. 

The key marked RETURN performs a carriage return; it both 
returns the character pointer to the beginning of the line and 
advances it to the next line. This key is used to terminate the 
line currently being typed and to terminate certain RT-11 
system commands. 

Locate the ESC key and the LINE FEED key. These are special 
command terminators that are described in Chapters 5 and 14. 

An important key is the CTRL key. It is always used with an- 
other character key to perform one of several system opera- 
tions. CTRL commands are explained in detail when you begin 
to use them later in the manual. 

Table 3-1 reviews the console terminal keyboard characters. 
Keys not mentioned are not used by the RT-11 computer 
system and can be ignored. 

You will have an opportunity to become familiar with your ter- 
minal keyboard as you perform the demonstrations in this 
manual. 

The console terminal also displays messages and responses 
from the system. These messages and responses provide or re- 
quest information. Error messages are an example of informa- 
tional output; they help you detect typing errors, programming 
errors, and system malfunctions. If an error message appears 
on your console terminal while you are performing the demon- 
strations in this manual, refer to the RT-11 System Message 
Manual for an explanation of the cause of the message and a 
description of the corrective action that should be taken. 



USING 

MASS STORAGE 

VOLUMES 



Mass storage volumes provide an area (apart from computer 
memory) to keep information for later use. The information 
may be user application programs, data needed by a program, 
the results of a program run, textual information, batch-type 
programs, and so on. As an example, the RT-11 operating 
system is stored on a mass storage volume called the system 
volume. When information is needed, as it was during 
bootstrapping, information from the storage volume is trans- 
ferred into computer memory. 
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Before you can access the information stored on a storage 
volume, however, you must first insert the volume (the me- 
dium) into its corresponding device unit (drive), the hardware 
device connected to the computer. Once a volume has been in- 
serted into a device unit, the device unit's symbol identifies the 
volume. There may be more than one device unit for a volume, 
each individual device unit is numbered 0, 1, 2, and so on. As 
you learned in the bootstrap procedure, the system volume is 
inserted in device unit and remains in it as long as you are 
using the system. Other storage volumes can be inserted in any 
available device units. Figure 3-3 illustrates several mass 
storage volumes. 



Table 3-1 Keyboard Characters 



Key 



Function 



BACK SPACE Ignored during normal system use 
Ignored during normal system use 



BREAK 
CTRL 

DELETE 

ESC 

LINE FEED 

REPEAT 

RETURN 



SHIFT 

TAB 

any other 
key 



Control; part of several two-key command 
combinations that perform specific system 
functions 

Erase; cancels the last character typed 

Command terminator; terminates an editing 
command string; transmits the command to 
the computer and performs a carriage return 

Command terminator; terminates certain 
system commands; transmits the command to 
the computer and performs a carriage return 

Ignored during normal system use 

Line terminator, command terminator; termi- 
nates the current line; terminates certain 
system commands; transmits the command to 
the computer and performs a carriage return 

Selects the uppermost of two characters ap- 
pearing on a key 

Moves the character nointer ahead to the be- 
ginning of the next tab stop 

Transmits the alphanumeric or special char- 
acter to the computer 
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Magtape 



Figure 3-3 Mass Storage Volumes 
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Mass storage volumes hold large amounts of information. Most 
volumes, however, are physically small enough so that you can 
transport them from the system, to your desk perhaps, or to 
another computer system. In addition to disks (shown earlier in 
Figure 1-4), magtapes are also mass storage volumes. 



You store information on a mass storage volume in the form of 
files. Each file is a logical collection of data. Files may be parts 
of programs or entire programs, program input data, or text, 
such as a letter or report. Whatever its content, each file is 
treated as a unit and occupies a fixed area of the volume. 

Every file on a mass storage volume has a unique name that is 
composed of a file name and a file tjrpe. The file name and file 
type identify the file and distinguish it from other files on the 
volume. You can instruct the system to print on your terminal 
the names of all files on a volume. The resulting list is called 
the volume directory listing. By referring to the volume direc- 
tory, you can find the name, size, and creation date of each file 
on that volume and delete old files that you no longer need. 
Whenever you perform an operation that affects the contents of 
the volume, a new volume directory reflects the change. 



File Storage 



Occasionally, after many files are added to a storage volume, 
the volume has no room for new information. A storage volume 
may also become damaged, lost, stolen, or worn through use. 
For these reasons it is a good idea to have several extra storage 
volumes on hand and to protect your more important files 
against accidental erasure or loss. 

One way to protect a file is to make a copy of it on a second 
storage volume. The copy, called a backup file, insures you 
against the loss or damage of your original file (or its respective 
storage volume). 

Some storage volumes provide a mechanism that protects files 
against accidental erasure. This mechanism is generally a 
switch on the volume itself, or on the device unit, that you can 
set to a write-protect or write-enable condition (as you did 
during bootstrapping). When the volume is write-protected, in- 
formation can be copied only from the volume to computer 
memory or to another volume that is write-enabled. A volume 
that is write-enabled, on the other hand, also allows informa- 
tion to be copied from memory back to the volume. 



File Protection 
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The RT-11 operating system itself provides a protection fea- 
ture. This optional feature requires that you confirm certain 
system commands that might otherwise erase important infor- 
mation. The system also issues prompting messages so that you 
provide the proper file information when it is needed by a com- 
mand. 

Chapter 4 and succeeding chapters require you to use the ter- 
minal to enter command information and perform file copy and 
other system operations. Before you continue, make sure that 
there is a backup copy of your system volume. If you cannot 
locate one, read Appendix B, Backing Up the System Volume, 
before going on. 



REFERENCES RT-ll System Message Manual (AA-5284D-TC). Maynard, Mass.: Digital 

Equipment Corporation, 1983. 

An explanation of system messages that may occur during normal 
system use; includes required user actions. 

VTIOO User Guide (EK-VT100-UG^002). Maynard, Mass.: Digital Equip- 
ment Corporation, 1978. 

A manual for the owners and operators of the VTIOO video terminal and 
for those who will be programming computers to interact with these 
devices. 
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USING THE MONITOR COMMAND LANGUAGE 



During the bootstrap operation, the RT-11 monitor was copied 
into computer memory and started. The RT-11 monitor is actu- 
ally many different components working together to supply 
basic system functions. For example, the part of the monitor 
called the resident monitor (RMON) provides the console ter- 
minal service and central program code necessary for a working 
environment for both system and user programs. The resident 
monitor is so named because it always remains in computer 
memory, regardless of other system operations that may be oc- 
curring. Other parts of the monitor are brought into memory 
from the system volume as needed. These include the user ser- 
vice routine (USR), which provides support for the RT-11 file 
system, and the keyboard monitor (KMON), which controls ter- 
minal keyboard interaction. From your standpoint, the key- 
board monitor is the most visible part of the system software. 
Among other services, it supplies the monitor command lan- 
guage that you use to control system operations. 

The monitor command language is a set of English-like com- 
mand words that you type on the terminal keyboard to initiate 
and control system operations. You can type a command in one 
of two general formats: a long format or a short format. The 
long format causes the system to print prompting messages. 
These messages ask you to supply specific information, such as 
file names and device names. The long format is helpful until 
you become familiar with the commands. You will then prob- 
ably prefer to use the short format, which allows you to enter 
all required information on a single command line and provides 
prompts only if you do not supply necessary information. Both 
formats are demonstrated throughout this manual. 

You terminate all monitor commands with a carriage return. 
That is, after you type the required com.m.and information, you 
press the carriage return key (represented in this manual by 
®). This instructs the monitor to initiate the command and to 
perform the operation. 

A prompt character — a period at the left margin of the ter- 
minal printer or screen — appears whenever the RT-11 mon- 
itor is waiting for you to type a command. The period is your 
cue that the system is in the monitor command mode and ready 
to accept a monitor command. Check the output on your ter- 
minal printer or screen. You should see the following at the left 
margin: 



ENTERING 

COMMAND 

INFORMATION 



RT-llFB 



y05.xx 
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RT-llFB identifies the RT-11 monitor called the 
foreground/background (FB) monitor. Following this is the ver- 
sion (and update) number of the system in use, in this case, 
Version 5. The period on the next line indicates that the system 
is in the monitor command mode and is waiting for you to type 
a monitor command. 



General Command 
Format 



Whenever you issue a monitor command, you must supply cer- 
tain information to guide command processing. This informa- 
tion includes the following (square brackets indicate optional 
qualifiers and characters): 



COMMAND[/option] 



INPUT[/option] 



First you indicate, by command, 
which system operation you want ini- 
tiated. Command options are avail- 
able to allow you to alter the normal 
(default) operation. 

You next indicate, by device and file 
name, input information that is to be 
used during the operation. The system 
volume serves as the default input de- 
vice. You must explicitly indicate 
other volumes that you want used for 
input, and you must usually indicate 
the file names and file types of the 
input files. Input file options are avail- 
able to allow you to alter assumed (de- 
fault) input operations. 

Finally you indicate, by device and file 
name, output information that is to be 
created as a result of the operation. 
The system volume serves as the de- 
fault output device. You must expli- 
citly indicate other volumes that you 
want used for output, and you must 
usually indicate the file names and 
file types of the output files to be cre- 
ated. Output file options are available 
to allow you to alter assumed (default) 
outnut Operations. 



As mentioned earlier, you can type this command information 
on the terminal keyboard in one of two formats; illustrations of 
both follow: 



OUTPUT[/option]i 



^OUTPUT[/option] is not always used; sometimes output must be specified as 
COMMAND[/option]INPUT/OUTPUT:filespec. 
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Long Command Format (system prompts for specific informa- 
tion) 

.COMMANDC/option]® 

INPUT PROMPT? INPUTC/option]® 

OUTPUT PROMPT? OUTPUT C / opt i on ]®l 

Short Command Format (no prompts) 

.COMMANDC/option] INPUTC / o pt i on ] OUTPUT [/ opt i on ]® 

Notice that a slash character (/) separates an option from the 
portion of the command that it qualifies, and a carriage return 
(HS) terminates each individual command line. When you have 
supplied all the necessary information, the carriage return sig- 
nals the monitor to execute the command. You can use either 
format; both are demonstrated throughout this manual. 

In addition to monitor commands, RT-11 has several special 
function commands, called control commands, that you type by 
first pressing and holding down the CTRL key on the terminal 
keyboard and then typing the letter key of the command. To 
execute the CTRL/C command, for example, type the letter C 
while holding down the CTRL key. These control commands 
require no terminator; the system performs the function as soon 
as you type the command. 

Control commands are used to interrupt program execution, to 
inhibit terminal output, and to perform other similar special 
system operations. They are described in the manual as you 
need to use them. 



Control Commands 



During the course of this chapter, and throughout the re- 
mainder of the manual, you will use a number of monitor com- 
mands to perform some common system operations. For ex- 
ample, you will list the directories of device volumes, copy files 
between devices, create files, and execute system and user pro- 
grams. You perform these operations by re-creating on the ter- 
minal keyboard the examples already provided for you. 

You should first read the entire explanation of a command to be 
aware of its format, the operation it performs, and the options 
that are available. Then type the command on the terminal 
keyboard exactly as you see it used. Characters that you type 
appear in the demonstrations in red print. Characters that are 
system responses are shown in black print. 

Table 4-1 lists symbols that you will see used throughout the 
demonstrations. These symbols represent various keys on the 



Re-Creating the 

Examples 
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terminal keyboard. When you see one of these symbols in a 
command line, tjrpe the appropriate key on the keyboard. 

Table 4-1 Keyboard Symbols 



Symbol 



Type 



(M) carriage return key 

© line feed key 

W space bar (once for each time the symbol is shown). 

Assume that you should type a single space unless 
you are otherwise instructed; the space symbol is 
used only if there is doubt about the number of 
spaces to type. 

@ TAB key (once for each time the symbol is shown) 

(elD DELETE key (once for each time the symbol is 

shown) 

HD ESCAPE key (once for each time the symbol is 

shown) 

[CTRL/x 1 CTRL key (hold down CTRL key while typing the 
letter character [x]) 



CORRECTING 

TYPING 

MISTAKES 



CTRL/U 



All commands that you give the system are typed on the ter- 
minal keyboard. If you make a mistake while typing a com- 
mand, you can correct it in one of two ways. 

One way to correct a typing error is to use the DELETE key on 
the keyboard. Pressing the DELETE key once cancels the char- 
acter just typed; pressing it a second time cancels the next to 
last character tjT)ed, and so on, from right to left, until the 
beginning of the line is reached. Then additional DELETEs are 
ignored. 

The second way to correct a typing error is to use CTRL/U, a 
special control command. Tjrping this command once is equiva- 
lent to typing as many DELETEs as are needed to cancel every 
character in the current line. 

T3^e on the keyboard the letters DABE, followed by two DE- 
LETES, followed by the letters TE, and notice the system's re- 
sponse: 



,DABE 



TE 



The monitor echoes each deleted character and encloses them 
within backslashes. As far as the monitor is concerned, the only 
characters you have tjrped are DATE. 
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.DABE\EB\TE 



Thus, your current line is DATE. Continue by typing a 
CTRL/U. Remember to first press and hold down the CTRL key 
and then type the U key; no carriage return is necessary. 



(CTRL/Ul 



Notice that CTRL/U echoes on the terminal printer or screen as 

.DABE\EB\TE-^U 

All characters on the line are canceled, and the character 
pointer is moved to the beginning of a new line so that you can 
enter another command. You are still in the monitor command 
mode even though no prompting period appears at the left 
margin. 

Once the carriage return or line feed key is pressed, the pre- 
vious line cannot be corrected with DELETE or CTRL/U. 

These two methods are commonly used to correct typing errors 
made at the keyboard. You can choose whichever method seems 
most convenient. 



The kinds of command operations that you usually perform im- 
mediately after the monitor is bootstrapped are those that set 
up initial conditions, such as the current date and time of day, 
and those that initialize and prepare the system for future oper- 
ations such as file transfers. If your system has VTll display 
hardware that you want to use, you should also enable (turn on) 
the graphics display screen. 



INITIAL MONITOR 

COMMAND 

OPERATIONS 



Display hardware on an RT-11 computer system consists of a 
cathode ray tube that allows programs to use graphics displays. 
If your system has display hardware^ (Figure 4-1), you can use 
the graphics screen in place of the terminal printer or screen. 

NOTE 

Check question 9 in the Hardware Configuration section 
of Chapter 2 to determine if your system has display 
hardware. If you do not have display hardware, go on to 
the next section, Entering the Date and Time-of-Day. 



Using VT11 Display 
Hardware 



^Video terminal screens are not considered graphics display hardware. 
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GT 



The monitor command that enables the graphics screen is the 
GT command. The GT command is used to change the condition 
of the graphics display. In this case, you will use it to activate 
the graphics display hardware so that the VTll display screen 
replaces the console terminal printer or screen as the terminal 
output device. 
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Figure 4-1 VTll Display Hardware 

Tjrpe the following on your terminal keyboard (if necessary, 
refer to Table 4-1 to review the special symbols): 



Long and Short Command Format 



.GT 



If your system does not have display hardware, the monitor 
prints a message^ on the terminal printer or screen informing 
you that the command is invalid for your system configuration: 

?KMDN-F-Inijal id conuiiand 

Otherwise, the command is accepted. You should notice that all 
character-echoing and system responses are now directed to the 
graphics screen instead of to the terminal printer or screen. 
After the command has been accepted, a period appears on the 
graphics screen, indicating that the system is waiting for an- 
other command. The character pointer is visible as a blinking 
rectangular cursor situated after the period. (In the edit mode, 
the cursor is L-shaped.) 



^The meanings of all system messages are listed in the RT-11 System Mes- 
sage Manual. 
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Like output on the terminal screen, output that appears on the 
graphics screen is temporary. Once the screen is filled, lines are 
rolled off the top and are lost to view. However, if your terminal 
has a printer, a special control command allows you to control 
console terminal output so that it appears on both the graphics 
screen and the terminal printer simultaneously. In this 
manner, you can direct selected portions of terminal output — 
directory listings, for example — to be both displayed and 
printed at the same time. The advantage of this is that al- 
though the display copy is eventually lost, you have a printed 
copy for later use. 

The control command that provides this function is CTRL/E, 
which is initiated by holding the CTRL key down while typing 
the E key. No carriage return is necessary. When you type this 
command, no characters echo on the graphics screen, but you 
should notice that all subsequent characters (both input and 
output) appear on both the graphics screen and the terminal 
printer. 



CTRL/E 



Thus, if your terminal has a printer and you wish to use the 
printer in addition to your VTll graphics screen, type once: 

SZE) (Remember, this command does not echo.) 

Now type the following and notice where the characters echo: 

• WRONG COMMAND i SrlTin 

To disable the printer at any time so that character echoing 
occurs only on the graphics screen, type another CTRL/E com- 
mand: 

iCTRL/E) 

Finally, to return terminal output control to the terminal, disa- 
bling the graphics screen, use the GT OFF command; this 
changes the terminal device handler back to its original output 
setting: 

Long and Short Command Format 

• GT OFF® 

Decide now whether to use the graphics screen for the re- 
maining demonstrations. If so, use the GT ON command to en- 
able the graphics screen, and remember that the CTRL/E com- 
mand is available when you wish to produce simultaneous 
output. 
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Entering the Date 
and Time-of-Day 




Entering the current date and time-of-day helps in record- 
keeping for system operations. Later, you can identify when 
system operations were performed. 

For example, by entering the current date you instruct the 
system to assign this date to all files you create. The date will 
also appear in volume directories and listings produced by the 
various language processors and utility programs. If your 
system has a clock, by specifying the current time-of-day you 
instruct the system to keep track of time based on the time you 
set. The current time is printed on listings when they are pro- 
duced, and may also be used to control certain program opera- 
tions. 

Enter the date by typing the monitor DATE command with the 
day, month, and year as follows (there is only one format): 

Long and Short Command Format 

.DATE 8-JAN-B3(bSI 



This sets the date to January 8, 1983. Since this date is not 
current, reenter the correct date using the same command 
format: 

.DATE dd-(HM(ii-yy(HS 




Typing the new date overrides the previous date. 

The date that is set is temporary. You must reenter it whenever 
you bootstrap the system. 

The monitor TIME command is used to set the time-of-day, 
specified in 24-hour notation. The system keeps track of time in 
hours, minutes, and seconds, based on the initial time that you 
enter in the command. Enter the time as follows (there is only 
one format): 



Long and Short Command Format 

.TIME ISsOlsOOdSl 

If your system does not have a clock, the monitor prints a mes- 
sage on the terminal; this message informs you that the com- 
mand is not valid for your system configuration: 

?KMON-W-No olooK 

Otherwise, the time is set to 3:01 p.m. If your system has a 
clock, reenter the correct time, using the same command 
format: 

.TIME hhsftKHSssdSl 
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T5T)ing the new time overrides the previous time. 

The system's clock stops when the system stops running. If you 
want the time to be kept current, you must reenter it whenever 
you bootstrap the system. If your system has a clock and you do 
not set the time, the TIME command will return the time 
elapsed since the last hardware boot. 

To check the time or date at any time while you are using the 
system, simply type either the DATE command or the TIME 
command, followed by a carriage return only: 

Long and Short Command Format 

. DATE® 
8-JAN-83 
, TIME® 
15: OB: 13 

The system responds by printing the date or the time, based on 
the information you previously entered. If the system responds 
to the DATE command with the message ?KMON-W-No date, 
the date has not been set since the system was last 
bootstrapped. 

Each hardware device in the RT-11 system is identified by a Assigning Logieai 

two-letter mnemonic. The mnemonics, listed in Table 4-2, are Mam@S t© D©vie®S 

defined in the system software and are recognized and used by 
the operating system. These are the device names that you gen- 
erally use in command input and output lines. However, you 
may want to change any of these device names temporarily, for 
a variety of reasons. The following paragraphs describe both 
using the physical device names shown in Table 4r-2 and as- 
signing logical (temporary) device names to devices. 

Table 4-2 Physical Device Names 



Mnemonic 


Device 


DUn: 


RC25/RD51 Disk, RX50 Diskette 


DLn: 


RLOl/02 Disk 


DMn: 


RK06/07 Disk 


DW: 


RD50/RD51 Disk (PC350) 


DXn: 


RXOl Diskette 


DYn: 


RX02 Diskette 


DZn: 


RX50 Diskette (PC325/PC350) 


LP: 


Line Printer 


LS: 


Serial Line Printer 


MMn: 


TJU16 Magtape 


MSn: 


TSll Magtape 


MTn: 


TMll Magtape 


RKn: 


RK05/RK11 Disk 


Tl': 


Console Terminal 
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Two additional logical device names are used. These special 
names are described in Table 4-3. 

Table 4-3 Special Logical Device Names 
Mnemonic Device 

SY: The volume from which the monitor was 

bootstrapped; that is, the system volume. 

DK: The default storage volume (initially the same 

as SY:; that is, the system volume). 



You use device names in the input and output portions of a 
command line to identify where input information can be found 
and where output information will be sent. If a file is involved, 
you also include its file name and file type, in the following 
format: 

deuioeriaMe:fileri awe. filet ype 

The device name is followed by a colon and is always separated 
from any file name and file t3T)e by a colon. The device name is 
generally one of the mnemonics listed in Tables 4—2 and 4r-3. 
When you use a device name in any command, you must also 
include the device unit number (represented by the letter n in 
Table 4-2) unless the number is 0. The system assumes unit 
of the device if no unit number is given. Thus, diskette unit is 
DY: or DYO:; diskette unit 1 is DYl:; RK: disk unit 2 is RK2:; 
and so on. Note that, according to Table 4-3, you can use the 
device mnemonic SY: or DK: for your system volume in addi- 
tion to its standard device name. However, since the system 
volume is initially the default storage volume for all operations, 
you do not need to use a device name for your system volume. 

The names listed in Tables 4-2 and 4-3 are the device names 
defined within the system software. However, you can change 
any of these name assignments temporarily, either by reas- 
signing existing names to different devices or by assigning new 
logical names of your own choosing to devices. 

You might want, for many reasons, to change a device name 
temporarily and assign it a logical name. You may, for ex- 
ample, have a program written for a device that is not available 
on your system. If you assign the program name to a device that 
is available, the program then uses that device instead.^ 

Since not all RT-11 users have access to the same kind of 
storage volume, you are instructed to assign the logical name 
VOL: to whatever volume you are using for storage. After you 



'This is called device independence. 
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make this assignment, subsequent command lines can be the 
same for everyone using this manual. 

Similarly, the special logical device name DK:, presently as- 
signed to your system volume, could be assigned to any kind of 
storage volume. Not only would DK: signify your storage 
volume, regardless of its physical device name, but you could 
also avoid typing DK: since it is the default storage volume for 
most commands. (Only the R command requires that the file 
specified be on the system volume SY:.) 

To assign a logical name to your storage volume, first deter- 
mine its physical device name. Check questions 7 and 8 in the 
Hardware Configuration section of Chapter 2 to see which de- 
vice and which device unit you are using for your storage 
volume. Translate this into the appropriate name and number 
using Table 4-2 as a guide. 

Use the monitor ASSIGN command to change this physical 
name to a logical name. Substitute for physical-device-name in 
the following command lines the physical name and device unit 
number for your storage volume (for example, for RK05 disk 
unit 1, substitute RKl:). 



ASSIGN 



Long Command Format 

.ASSIGNdU 

Physical deyioe name? physical' 

LoSioal device name? yOL;® 



deyice-nawed 



Short Command Format 



•ASSIGN phys ical-deu ice-nawe VOL: 



Once the assignment is made, the system recognizes the logical 
name VOL: as the device name for your storage volume. This is 
the only logical assignment you need to make. Since you are 
not changing the DK: assignment, the system volume remains 
the default device for all I/O operations. 

As you continue to use the system, you may well make many 
device assignments and deassignments. To check the status of 
ail assignments made during a computer session, you can use 
the monitor SHOW command to print on your terminal a list of 
all the logical assignments currently in effect. Use the SHOW 
command now to check the status of the assignment just made: 




Long and Short Command Format 

.SHOW® 
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Check the list printed on your terminal to make sure that the 
code VOL: has been assigned to your storage volume. The let- 
ters VOL: should follow the appropriate device name in the list, 
as in the following response, in which VOL: represents disk 
unit 1: 



TT 
RK 



LD 
DX 
DT 
DD 
CT 
LP 
LS 
PC 
BA 
NL 
13 



(Resident) 



RKO 
RKl 



SY 

yoL 



DK 



free slots 



Logical device assignments are temporary. Thus, if you want a 
logical device assignment to remain in effect, you must reassign 
it each time the system is bootstrapped. 



Listing Volume 
Directories 



DIRECTORY 



CTRL/0 



Both your system volume and your storage volume have direc- 
tories, which are compiled lists of all the files stored on the 
volume. You can print a volume directory on your terminal, 
using the monitor DIRECTORY command.' To list the direc- 
tory of your system volume, type: 

Long and Short Command Format 

.DIRECTORY® (The System volume is the default device.) 

Since the directory of the system volume may be quite long, 
after approximately 10 lines have printed on the terminal, type: 

(CTRL/ 01 

This special control command, echoed as '0, inhibits the re- 
mainder of the listing output from printing on the terminal, 
although the information on the total number of files and 
uiv/uxvo xa oi/ii.1 givoix. YTiicii cuiibiui ictuiiiB bu iinjiiiLui' commaiiu 
mode, look at the directory listing. At the top of the listing is 
today's date, as you entered it earlier in the DATE command. 
Following the date is a list of the files on the volume. Notice the 
two-column format of each line in the directory. 



'Users of VTll display hardware may wish to use the CTRL/E command to 
enable both the graphics screen and the terminal printer for the following 
exercises. 
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08-Jan-83 



SWAP 


.SYS 


ZB 


2B-AUS-82 


RTllSJ 


.SYS 


73 


2B-AUS-82 


RTllFB 


.SYS 


BG 


2G-AU3-82 


RTllBL 


.SYS 


73 


2G-AU3-82 


RTllXM 


.SYS 


94 


2B-AUS-82 


TT 


.SYS 


2 


2G-AUS-82 


DT 


.SYS 


3 


2G-AUS-82 


DP 


.SYS 


3 


26-AU3-82 


DX 


.SYS 


3 


ZG-AU3-82 


DY 


.SYS 


i\ 


2G-AUS-82 


RF 


.SYS 


3 


2G-AUS-B2 


RK 


.SYS 


3 


2B-AUS-82 


DL 


.SYS 


a 


2G-AU3-82 


DU 


.SYS 


U 


2B-AU3-82 


DM 


.SYS 


5 


2B-AU3-82 


DS 


.SYS 


3 


2B-AU3-82 


DD 


.SYS 


5 


2B-AUS-B2 


'D 








170 Fi 


les , 


42G4 Blocks 










USB Free bl 


ocks 













First the file name appears, followed by a dot and a file type 
that is frequently used to identify the file's format. For exam- 
ple, .SYS represents a system file; other RT-11 file types used 
to represent different kinds of files are listed in Table 4-4. Af- 
ter the file tjrpe is a number that indicates the size of the file. 
The size is given in blocks, a term used to designate a standard 
amount of information. A file that is 1 to 10 blocks long is fairly 
small, while a file over 100 blocks in length is quite large. The 
date on which the file was created is shown at the right. This 
space is empty if a date was not specified (with the DATE com- 

Table 4-4 File Types 
File Type Meaning 

.BAG BASIC compiled file 

.BAK Editor backup file 

.BAS BASIC source file 

.BAT BATCH source file 

.BUP Backup/restore file 

.COM Indirect command file or IND indirect control file 

.CTL BATCH control file 

.DAT BASIC-11 or FORTRAN IV data file 

.DBL DIBOL source file 

.DIF SRCCOM output file 

.DIR Directory listing file 

.DSK Logical disk file 

.FOR FORTRAN IV source file 

.LOG Batch log file 

.LST Listing file 

.MAC MACRO-11 source file 

.MAP Linker map file 

.MLB MACRO library file 

.OBJ MACRO-11, FORTRAN IV, or DIBOL object out- 
put file or library file 

.REL Executable foreground program file or system job 

.SAV Executable background program file 

.SML System MACRO library 

.SYS System files and handlers 
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DIRECTORY 
/BRIEF 



CTRL/C CTRL/C 



mand) on the day the file was created. At the end, you are told 
how many files are on the volume, their total length, and the 
number of firee blocks available for your use. 

NOTE 

Files furnished on the distribution medium have a pro- 
tected status, which means they cannot be deleted. This 
is indicated by the letter P after the file size shown when 
you print a directory listing. You cannot perform any op- 
eration on a protected file if the result is to delete it. You 
can change the protected status of a file by using the 
RENAME keyboard monitor command with the /PRO- 
TECTION or /NOPROTECTION option; you can give a 
protected status to a file by using the PROTECT key- 
board monitor command; and you can remove a pro- 
tected status from a file by using the UNPROTECT key- 
board monitor command (see the RT-11 System User's 
Guide). 

You can also obtain an abbreviated directory, which omits file 
lengths and dates and lists only file names and file types in 
five-column format. To do this, you use the DIRECTORY com- 
mand with its /BRIEF option. Type the following, and after 
several lines have listed, interrupt the directory by t3^ing two 
CTRL/C command characters. This double control command 
echoes two "Cs and requests the running program to abort im- 
mediately, regardless of what the program is doing (one 
CTRL/C aborts an executing program waiting for input from 
the console terminal). Control returns to monitor command 
mode. 

Long and Short Command Formats 



.DIRECTORY/BRIEFdH 
















08-Ja)-i-B3 


















SWAP .SYS 


RTllSJ 


.SYS 


RTllFB 


.SYS 


RTllBL 


.SYS 


RTUKM.S' 


'S 


TT .SYS 


DT 


.SYS 


DP 


.SYS 


DK 


.SYS 


DY .S^ 


'S 


RF .SYS 


RK 


.SYS 


DL 


.SYS 


DU 


.SYS 


DM .S' 


'S 


DS .SYS 


DD 


, SYS 


LP 


.SYS 


LS 


, SYS 


CR .S' 


'S 



(CTBL/ClfCTRL/Cl 



DIRECTORY 
/PRINTER 



Volume directories can be printed on a line printer if one is 
available on your system. Check the answer to question 9 in the 
Hardware Configuration section of Chapter 2 to determine if 
your system has a line printer. Since listings print faster on a 
line printer than on the console terminal, it is to your advan- 
tage to use the line printer for large amounts of output. The 
/PRINTER option is used with the DIRECTORY command to 
cause a directory to be printed on the line printer instead of on 
the terminal. Make sure your line printer is turned on, and 
then type the DIRECTORY command as shown: 
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Long and Short Command Format 

.DIRECTORY/PRINTEF 



The Hsting may be quite long. When the Hne printer has fin- 
ished printing, retrieve the Hsting. 



InitiaHzing a storage volume clears its directory. A new 
(unused) volume should always be initialized before it is first 
used. In addition, any storage volume that contains files that 
are no longer needed can be initialized to recover the storage 
space. Note, however, that an initialize operation is used to 
remove all file names from the directory. So before you ini- 
tialize a volume, make sure that it contains no files that you 
might want later. 

Since you will use your storage volume to store several new 
files (created as a result of the various exercises in this 
manual), clear its directory using the monitor INITIALIZE 
command. This operation ensures that the volume has room for 
new files. 



Long Command Format 

.INITIALIZE® 
Device? MOL:®) 



(VOL: is the assigned logi- 
cal device name for your 
storage volume.) 



RKl : /Initial ize i Are you si.ire?Y® 

Short Command Format 



.INITIALIZE UOL:0 
RKl : /Initial ise ; 



Are you sure?Y(Bl) 



The system prompt physical-device-name/Initialize; Are you 
sure? gives you an opportunity to verify the command. Typing a 
Y initiates the operation, while N stops the operation and re- 
turns control to the monitor command mode. Check your com- 
mand line, make sure you are initializing your storage volume, 
and then type a Y. Again, list the directory of the storage 
volume. It should be empty. 

Long and Short Command Formats 

pv T nr-nxno V lini . tocti 

8-Jan-B3 

Files) BlocKs 
4762 Free blocks 

The number of blocks available for use on the volume is printed 
at the end of the directory and varies depending on the type of 
device you use as your storage volume. 



Initializing the 
Storage Volume 



INITIALIZE 
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The commands you have performed in this chapter have pre- 
pared the system for major operations that will follow. In 
Chapter 5 you begin by using the RT-11 editor to create text 
files that you will store on your initialized storage volume. 



SUMMARY: 
INITIAL 
MONITOR 
COMMANDS 



ASSIGN physical-device-name logical-device-name 

Assign a logical device name to a physical device name. 

DATE 

Print the current date, if previously set. 

DATE dd-mmm-yy 

Set the current date (day-month-year). 

DIRECTORY ddn: 

List the volume directory on the terminal (ddn: is the mne- 
monic for the device name; the default storage volume, DK:, 
is assumed if ddn: is not specified). 

DIRECTORY/BRIEF ddn: 

List a brief volume directory on the terminal, showing only 
file names. 

DIRECTORY/PRINTER ddn: 

List the volume directory on the line printer. 

DIRECTORY/PRINTER/BRIEF ddn: 

List a brief volume directory on the line printer. 

GT OFF 

Disable the VTll display hardware. 

GTON 

Enable the VTll display hardware so that the graphics 
screen replaces the terminal printer/screen as the terminal 
output device. 

INITIALIZE ddn: 

Clear the directory of the indicated volume (ddn: is the mne- 
monic for the device name and must be specified). 

SHOW 

Print the status of all current logical device name assign- 
ments. 

TIME 

Print the current time, if previously set. 

TIME hh:mm:ss 

Set the current time-of-day (hour:minute:second). 
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CTRL/C CTRL/C 

Interrupt the current operation or program and return con- 
trol to monitor command mode. 

CTRL/E 

Direct terminal output to both the graphics screen and the 
terminal printer simultaneously. Type a second CTRL/E to 
return output control to the graphics screen only. (Valid only 
when VTll display hardware is enabled.) 

CTRL/0 

Inhibit the remainder of output from printing on the termi- 
nal. 

CTRL/U 

Cancel every character in the current line. 

DELETE 

Cancel the last character typed on the current line. 



SUMMARY: 

SPECIAL 

CONTROL 

COMMANDS 



LPlllLSll Line Printer Manual (EK-LPll-TM-005). Maynard, Mass.: 
Digital Equipment Corporation, 1975. 

A hardware manual for the owners and operators of LPll/LSll line 
printers and for those who will be programming computers to interact 
with these devices. 

RT-11 Mini-Reference Manual (AA-M241A-TC). Maynard, Mass.: Digital 
Equipment Corporation, 1983. 

A summary of all RT-11 monitor commands, command options, system 
utility program operating commands, and programmed requests. 

RT-11 System User's Guide (AA-5279C-TC). Maynard, Mass.: Digital Equip- 
ment Corporation, 1983. 

A guide to the use of the RT-11 operating system. 
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CHAPTER 5 
CREATING AND EDITING TEXT FILES 



The ability to create and edit text files is one of the most useful 
features of the RT-11 operating system. Not only can you 
create computer programs, data files, memos, and reports on 
line (that is, under the control of the system), but you can alter 
what you create without retj^ing the entire file. 

You create and edit text files more often than you perform any 
other system operation. Therefore it is essential that you be- 
come familiar with the editing process as quickly as possible. 
Editing should become second nature to you as you learn to use 
the RT— 11 computer system. 



Two RT-11 editor system utility programs, EDIT.SAV and THE RT-11 EDITOR 

KED.SAV, are stored as part of the RT-11 operating system on 
your system volume. The demonstrations in this manual illus- 
trate EDIT, which can be used on a video terminal or a hard- 
copy terminal. The use of KED is restricted to video terminals. 
For more information about KED, refer to the PDP-11 Keypad 
Editor User's Guide. 

Text files that you create with the editor are stored in the com- 
puter in ASCII format. ASCII, which stands for the American 
Standard Code for Information Interchange, is an industry- 
standard code that consists of a numeric representation for each 
of the alphabetic characters (A to Z), the numeric characters (0 
to 9), the punctuation characters, and some special communica- 
tion control characters. When you tj^e text on the terminal 
keyboard, the system automatically converts the text to ASCII 
codes; when you request listings on the terminal or line printer, 
the system converts the ASCII code back to the text characters. 

The RT-11 editor uses a specially reserved area of computer 
memory to hold the text you are creating or editing. This area 
of memory is called the text buffer. When you create text, the 
characters that you type on the terminal keyboard are 
transmitted directly into the text buffer. When you edit text, 
the characters are copied from the input file into the text 
buffer, where you can modify them. When you have edited the 
text in the buffer to your satisfaction, the characters are moved 
out of the text buffer to the output file (Figure 5-1). 
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Creating and Editing Text Files 



COMPUTER 



INPUT 




OUTPUT 
/ OUTPUT ) 

v3/ 



Figure 5-1 Editing with RT-11 

Since the text buffer is a Hmited area of computer memory, you 
may at times try to input more text than the buffer can accom- 
modate. If this condition becomes apparent to the editor, it 
prints a warning message on the terminal telling you that, be- 
fore you can input any more text, you must make room in the 
buffer, either by transferring text to the output file or by 
erasing text already in the buffer. 

You can avoid this inconvenience during editing if you make 
use of a concept called paging. When you create a large text file, 
instead of typing the file as one long stream of text, divide it 
into individual pages of approximately 50-60 lines in length; 
this corresponds roughly to the size of a line printer or terminal 
listing page. You can copy the text into and out of the buffer 
one page at a time. A single page of text is never too large for 
the text buffer and also fits on the line printer or terminal 
perforated paper when you obtain a listing. 



CREATING A 
TEXT FILE 



EDIT/CREATE 



You activate the editing capability by using the monitor EDIT 
command. When creating a file, you must use the /CREATE 
option followed by the file name and file type you want as- 
signed to the new file. The default storage volume (DK:) serves 
as the default device, so unless you specify a device using one of 
the mnemonics in Table 4^2, the editor creates the new file on 

J-1- - J :__ T\T7-. / l.;_T- 4„ J-1 J- 1 1 1 1 — :_ 

i/iitJ u.t5vn;t! ur^. vwiuuii lis wic sysi/Ciii vujLuiiit;, uiiiess ciiaiigeu via. 

ASSIGN). 

First, if you are using display hardware, disable it with the 
monitor GT OFF command; the editor has a special display 
capability that is not described until later in this chapter. 

Long and Short Command Format 

,GT OFF® 
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Next, use the editor to create a text file of five lines. Call the 
file DECIND.USA, and use the default storage volume — cur- 
rently the same as the system volume — for the file. 



Long Command Format 

.EDIT/CREATEEH 
File? DECIND.USA® 
* 



Short Command Format 

.EDIT/CREATE DEC IND . USAdSl 
* 



Once the output file is open (that is, when the appropriate file 
has been established for output operations), the editor prints a 
prompting asterisk at the left margin. The asterisk indicates 
that the editing command mode is in control. This prompt is 
your cue to enter an editing command. 

The editing command used to create text is the I (Insert) com- 
mand. Type: 



#1 



INSERT 



All subsequent characters that you type on the terminal key- 
board will now be entered into the text buffer just as you tjrpe 
them. Enter the following text exactly as shown, including all 
spaces and errors. Before you type the RETURN key, check the 
line to make sure that it matches what is shown here. Re- 
member, if you make a typing mistake that is not intentional, 
you can use the DELETE key on the terminal keyboard to erase 
individual characters and the CTRL/U command to erase all 
characters on the current line. When you have finished typing 
the five lines, type the ESCAPE key twice. The ESCAPE key 
echoes on the terminal as a $; it is used to execute an editing 
command and to return control to editing command mode. 



ESCAPE ESCAPE 



#IWE HOLD THESE TRUTS TO BEE SELF-EUIDENT t(@ 
THAT ALL MEN ARE CREATED EQUAL » THAT THEY® 
HAUE UNRELIABLE TENDENCIES OF WHICH THEY® 
AR ENDOWED BY THEIR CREATOR. THAT AMONG® 
THESE ARE LIFE. LIBERTY AND HAPLENESS.® 



Forget for the moment that this text contains several misspell- 
ings and other errors, and assume instead that you are satisfied 
with it and ready to transfer it from the text buffer to the 
output file. The EX (Exit) editing command performs this func- 
tion. This command terminates editing, transfers all text in the 
text buffer to the output file, closes the currently open output 



EXIT 
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file (making it unavailable for further output operations), and 
returns control to monitor command mode, indicated by a dot at 
the left margin. Use the EX command to close the file 
DECIND.USA: 



*EX 



You now have a file on your system volume called 
DECIND.USA, consisting of the five lines of text you just cre- 
ated. 



EDITING A 
TEXT FILE 



EDIT 



The file DECIND.USA needs editing. To edit a file, you again 
use the EDIT command to activate the editor. Next indicate in 
the command line the two-letter device mnemonic for the 
volume on which the file resides (the default storage volume, 
DK:, is assumed). Following this, you indicate the file name 
and file t5^e of the file. The editor then opens the file, making 
it available for input operations. 

Thus, to open the file DECIND.USA for editing, type: 
Long Command Format 

.EDIT(BSI 

File? DECIND.USA® 

* 

Short Command Format 



.EDIT DECIND.US 
* 



READ 



The EDIT command opens the input (and output) files. Use the 
R (Read) editing command to read the first page of text from the 
input file into the text buffer. No output occurs to the output 
file, but the file is available for output at a later time. The 
input file itself is not altered in any way. 



BEGINNING 



Whenever text is read into the text buffer, a pointer is automat- 
ically positioned at the beginning of the text. This pointer is an 

■iIi->TTTioil-vlo ■i-nirl-i/»o-f rvT* -fria-f aoT*Troc3 oa o ■foT^rro'f 4v\t» ziHi'f i-nrr o/mttitv* o-r»r1cj 

XXX V XOXILrX<C^ XXX\XXVCXV\J'X UXXCXU VD\^J. y \^tD CCk? C«. \JfJLl.pyX^V XVfX \y\A,XVM.XXQ \^\I XXi.XI.XtA.XM.XA.Cf I 

The pointer pinpoints the exact location in the file where the 
next character will be inserted. For example, when you finished 
inserting text earlier (just before using the EX command), the 
pointer was positioned at the end of the file. Now that the EDIT 
command has been used to read text into the text buffer, the 
pointer is positioned at the beginning of the text in the text 
buffer. If the pointer is not at the beginning and you want to 
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move it there, you can use the B (Beginning) command; this 
command moves the pointer to the beginning of the text in the 
text buffer, no matter where the pointer is currently positioned: 



With the pointer positioned at the beginning of the text buffer, 
you can use the L (List) editing command to list the text cur- 
rently in the text buffer on your terminal printer. The List 
command lists text, starting at the pointer and continuing to 
whatever place you indicate by the command argument. 

A command argument is simply a prefix to an editing command 
that sets limits on the command's actions. Command argu- 
ments are used frequently and are summarized in Table 5-1. 
Study this table for a moment before continuing. 



LIST 



Table 5-1 Command Arguments 



Argument 



Meaning 



n 





/ 



Represents any integer in the range -16383 to 
+ 16383; it may be preceded by a + or -. If no 
sign precedes n, it is assumed to be positive. 
Whenever an argument is acceptable in a com- 
mand, its absence implies an argument of 1 (or 
-1 if only the - is present). 

Refers to the beginning of the current line. 

Refers to the end of text currently in the text 
buffer. 



Thus, with the pointer positioned at the beginning of the text, 
use the / argument and the L command to list on the terminal 
all text in the buffer. The position of the pointer does not 
change. List the text and compare your output with the five 
lines shown in the following example — they should match ex- 
actly. 



*/L 

WE HOLD THESE TRUTS TO BEE SELF-EUIDENT , 

THAT ALL MEN ARE CREATED EQUAL , THAT THEY 

HAVE UNRELIABLE TENDENCIES OF WHICH THEY 

AR ENNDOWED BY THEIR CREATOR, THAT AMONG 

THESE ARE LIFE, LIBERTY AND HAPLENESS. 

* 



If your output and the five lines above do not match exactly, 
then you probably typed some unintentional errors into 
DECIND.USA. 
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The remaining EDIT commands in this exercise depend upon 
an exact reproduction of DECIND.USA to function properly. 
Therefore, since you are not yet familiar with the EDIT com- 
mands necessary to correct your file, an existing copy of 
DECIND.USA with intentional errors must be substituted. 

Prepare the text buffer by erasing it with CTRL/C(ic)|sg. This 
unusual command combination is required by the EDIT pro- 
gram when you want to exit without creating an output file. 
The structure of the command prevents you from accidentally 
eliminating a file with a single CTRL/C. 



♦ CTL/Cl fESClfpl 

The monitor command mode period appears, signaling your de- 
parture from the editing command mode. Your system volume 
still contains the file DECIND.USA that you created earlier. 
However, it also contains the copy provided with the system, 
DEMOED.TXT, which you will use for the remainder of the 
exercise. 

Before going any further, you must rename DEMOED.TXT to 
DECIND.USA to avoid confusion. A RENAME operation, ex- 
plained fully in the File Copying Operations section of Chapter 
7, is the method of choice. Type the following command: 

.RENAME DEMOED.TXT DECIND.USA® ) 

The contents ofDEMOED.TXT are now labeled DECIND.USA. 
Note, however, that if a file labeled DECIND.USA already ex- 
ists and you rename another file to DECIND.USA, the system 
deletes the first file named DECIND.USA and renames the cur- 
rent one. Type EDIT DECIND.USA © to open the file for 
input, and type the R command to read it into the text buffer. 

.EDIT DECIND.USA® ' 



Since the pointer automatically returns to the beginning of the 
text with an R command, you can type /L to list the entire file. 

WE HOLD THESE TRUTS TO BEE SELF-EUIDENT . 
THAT ALL MEN ARE CREATED EOUAL » THAT THEY 
HAUE UNRELIABLE TENDENCIES OF WHICH THEY 
AR ENDOWED BY THEIR CREATOR* THAT AMONG 
THESE ARE LIFE* LIBERTY AND HAPLENESS. 
* 
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The text contains errors and misspellings deliberately intro- 
duced for the purposes of the exercises in this chapter. To cor- 
rect the errors, reposition the pointer so that it is near the text 
you want to change. The J (Jump) command, for instance, in 
conjunction with a command argument, moves the pointer ei- 
ther backward or forward by the specified number of charac- 
ters, including spaces. Type the J command now, using an argu- 
ment of 18, to reposition the pointer 18 places ahead^: 




*18 
* 



Although you cannot see it, the pointer has moved from the 
beginning of the text buffer to the right of the 18th character. 
You can verify this by using the List command again. The List 
command with no argument prints from the pointer to the end 
of the current line and thus exposes the location of the pointer: 

S TO BEE SELF-EMIDENT» 
* 

The characters in the example should match the current line on 
your terminal, showing the pointer positioned at the first error 
in the text where an H is missing in the word TRUTS. Since the 
pointer is positioned between the second T and the S, use the 
Insert command to insert an H in the proper place: 



*i 
* 



Now use the V (Verify) command to verify the line. The V com- 
mand, which does not require arguments, prints the entire line 
containing the pointer (the current line) on the terminal. It 
allows you to verify that a correction was properly made. The 
pointer is not moved as a result of the V command; its position 
remains just to the right of the last inserted character (shown 
here by the arrow): 



VERIFY 



WE HOLD THESE TRUTHS TO BEE SELF-EVIDENT, 
* I 



^Anytime you use the Jump command to move the pointer forward (or back- 
ward) by enough characters so that it moves to a new line, you must account 
for two extra characters in the command argument. This is because the editor 
treats the carriage return at the end of each line as two characters — a 
return and a line feed. 
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So far you have entered and executed editing commands one at 
a time. You can enter multiple commands by separating each 
individual command with a single ESCAPE. Tjrping two ES- 
CAPES then executes all the commands in the entire command 
string in consecutive order. For example, combine the J and L 
commands as shown in the following command string: 



*7u 

E SELF-EVIDENT , 

* 



CTRL/X 



The 7J moves the pointer seven positions to the right, and L 
then lists the text from the pointer to the end of the line so that 
you can see the pointer's new position. 

A special CTRL command is available to erase multiple editing 
commands. The CTRL/X command (hold the CTRL key down 
and type the X key) causes the editor to ignore an entire com- 
mand string that might extend over several lines if the I com- 
mand is involved. The editor echoes with 'X, issues a carriage 
return, and prints an asterisk indicating that you are still in 
editing command mode and can enter a new command. For ex- 
ample, type: 



#70J|E)I START A(i 
NEW LINE gfroTxl 



DELETE 



In addition to the CTRL/X command, you may still use the 
DELETE key to erase individual characters in the command 
line one at a time, and the CTRL/U command to erase all char- 
acters entered on the current command line. 

Since you used the CTRL/X to ignore this last command string, 
the pointer is still positioned at the next error in the 
file — just before the extra E in the word BEE. You can erase 
this extra character by using the D (Delete) command.^ The D 
command removes one character (or space) to the right of the 
pointer for every + 1 in its argument and one character to the 
left for every -1. Use the D command to erase the extra E and 
then verify the line ( + 1 is assumed if no argument is used): 



*D(iie)y(ii2)(i2) 



WE HOLD THESE TRUTHS TO BE SELF-EUIDENT 
# I 



^The Delete command should not be confused with the DELETE key on the 
terminal keyboard. While both perform the delete function, the D command is 
used to erase characters already within a text file; the DELETE key is used to 
erase typed characters in a command string or during text creation. 
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As you can see from the position of the pointer in the example 
(shown by the arrow), the D command does not actually move 
the pointer, but simply erases characters around the pointer. 
Since the extra E was erased, the pointer is now positioned 
between the E and the space. 

Just as you can use the Jump command to move the pointer by 
characters, you can use the A (Advance) command to move the 
pointer by entire lines. Again you give the command an argu- 
ment that indicates the number of lines, either forward or back- 
ward. The pointer is positioned at the beginning of the new 
line. Use the A command to move the pointer forward two lines, 
and then list the current line: 



ADVANCE 



*ZA(iic)L(iE)(il2) 

HAME UNRELIABLE TENDENCIES OF WHICH THEY 



This entire line does not belong in the text. To erase it, you 
could count the number of characters in the line and use this 
number as an argument to the D command; however, there is 
an easier way. The K (Kill) command erases the entire line 
following the pointer and positions the pointer at the beginning 
of the next line in the text. Type: 




*K(le)L|sc)(isc) 

AR ENDOWED BY THEIR CREATOR* THAT AMONG 

* 

The pointer is now at the beginning of the next line in the text. 
As you can see, this line also contains an error, the word ARE is 
incorrectly spelled as AR. Use the J command to jump over two 
characters, and insert the E. Then verify the line: 

*ZJ(lc)IElD'.'®|sQ) 

ARE ENDOWED BY THEIR CREATOR, THAT AMONG 

* I 



The arrow shows where the pointer is now positioned. This line 
still contains an error — it is missing the words WITH CER- 
TAIN INALIENABLE RIGHTS, which should follow the word 
CREATOR. You can count the number of characters from the 
pointer to the second R in CREATOR and then jump the pointer 
by this number, or you can use the G (Get) command. The G 
command searches, from the pointer, for the first occurrence of 
a specified character string and leaves the pointer at the end of 
that string. Use the G command to search for the string OR (in 
CREATOR); then insert the missing words and list the lines 
that have changed. Notice how you use the carriage return to 



GET 
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break the line into two parts (the 
where you should insert spaces): 



symbol is used to show 



# GORID I illW I THdElCERT A I Ndll 

I NAL I ENABLEiElR I GHTSID- Allc)2L(iSl(lD 

ARE ENDOWED BY THEIR CREATOR WITH fcERTAIN 

INALIENABLE RIGHTS, THAT AMONG 

* 



To list both lines, it was necessary to move the pointer back to 
the beginning of the first line you changed; this was done by the 
-A command. The 2L command then listed both lines. Notice 
where the pointer is; it was moved by the -A command and was 
not repositioned by the L command. 

You must be carefiil when you use the Get command, because 
the character string you specify must be unique if you want the 
pointer to move to the correct spot. For example, if the charac- 
ters OR had occurred anywhere after the pointer and before the 
word CREATOR, the pointer would have stopped there instead, 
and you would have inserted text in the wrong place. 

The final errors in this text occur in the last line. The words 
THE PURSUIT OF are missing, and the word HAPLENESS is 
a misspelling. Use the Get command to move the pointer to the 
word AND and insert the missing text. Move the pointer again 
with the Get command to the PLE of HAPLENESS; erase the 
LE, and insert PI. Then verify the line: 

*GAND|SC)I©THE(DPURSUITiP)OFlE)IE) 
* G P L E HE) - z D dc) I P I ID U m® 

THESE ARE LIFE, LIBERTY AND THE PURSUIT OF HAPPINESS. 
* 



CTRL/L 



Large text files — 50 lines or more — should be delimited 
into pages. To do this, insert a form feed into the text at the 
place where you want the page to end. A form feed is typed as a 
CTRL/L (hold the CTRL key down and type the L key), which 
the editor recognizes as a page break. 

Since this text file is only five lines long, there is really no need 
to delimit it as a page. However, for the sake of practice, insert 
a form feed at the end of this file. Then move the pointer to the 
beginning of the text buffer and list the entire text. Compare 
your text with the following example. If errors remain in your 
file, fix them by using the commands described so far. 



*G.i 



(CTRL/L echoes as eight line feeds.) 



5-10 



Creating and Editing Text Files 



/ 

WE HOLD THESE TRUTHS TO BE SELF-EUIDENT t 
THAT ALL MEN ARE CREATED EQUAL , THAT THEY 
ARE ENDOWED BY THEIR CREATOR WITH CERTAIN 
INALIENABLE RIGHTS* THAT AMONG 
THESE ARE LIFE. LIBERTY AND THE PURSUIT OF HAPPINESS. 



This text is correct in spelling and content, but the last two 
lines should be justified to make them easier to read. The 
pointer is currently at the beginning of the text. Use the G 
command to search for the character string AMONG; then in- 
sert and delete text to justify the lines. Finally, list the text 
again: 

*GAMONGIlE)IliElTHESE(sp) ARE® AdDlODlDBlD/LllcKlD 
WE HOLD THESE TRUTHS TO BE SELF-EMI DENT . 
THAT ALL MEN ARE CREATED EQUAL. THAT THEY 
ARE ENDOWED BY THEIR CREATOR WITH CERTAIN 
INALIENABLE RIGHTS. THAT AMONG THESE ARE 
LIFE. LIBERTY AND THE PURSUIT OF HAPPINESS. 



Once you are satisfied with your text, you are ready to transfer 
it to the output file. You could use the EX command to transfer 
the text, as you did earlier in the section Creating a Text File. 
However, suppose your input file has additional pages of text 
that require editing. If you use the EX command, all remaining 
text in the input file will be read through the text buffer into 
the output file, and the files will be closed although you may 
want to do more editing. To avoid this, you can use the N (Next) 
command. This command transfers the text currently in the 
text buffer to the output file, clears the text buffer, and reads in 
the next page from the input file. The pointer is positioned at 
the beginning of the text buffer. 



NEXT 



?EDIT-F-End of input file 

# (No text remains in the input file.) 

If you use the N command when no text remains in the input 
file (as just happened), the editor prints a message on the ter- 

xjt.i.j.j.j.cii. u'cxxj.xjLg j\j\jL ou. xxi; fxxxi:} ^v/xxxu, jv^uL voLxx uji' pc; l/XXC XJ^X V/^J-XXX- 

mand to close the file. 



«E 
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When you close a file after editing, the editor creates a file on 
the default storage volume (or system volume). It gives this 
new file the file name and file type that you indicated for input. 
It then renames the input file so that the file retains its file 
name but is assigned a file type of .BAK. This file type identi- 
fies a backup file, here an original input file retained in case of 
editing mistakes or accidental deletion of the new file. Thus you 
now have two versions of the DECIND file on your system 
volume: DECIND.USA, which is the edited version, and 
DECIND.BAK, which is the unedited (original) input file. 
Verify this by using the monitor DIRECTORY command: 

Long and Short Command Format 

.DIRECTORY DECIND.*® 

08-Jan-83 
DECIND.BAK 1 08-Jan-83 DECIND.USA 1 08-Jan-83 

2 Files. 2 Blocks 

496 Free blocks 



The asterisk (*) following DECIND. is a type of shorthand nota- 
tion called wildcard construction. Here it means to list all files 
named DECIND, regardless of their file tsrpe. Wildcard con- 
struction is explained in detail in the Multiple File Operations 
section of Chapter 7. 

Whenever you edit the same file a number of times, new ver- 
sions overwrite old versions. Thus only two versions of the 
edited file (filnam.BAK and filnam.typ) ever reside on a volume 
at one time. 



USING UPPERCASE 
AND LOWERCASE 
CHARACTERS 



Edit Lower 



Later model terminals (for example, LA120 DECwriters and 
VTIOO video terminals) have the capability to print in upper- 
case and lowercase. Certain line printers also have this capa- 
bility. You can use the uppercase/lowercase capability of these 
devices if you tjrpe the EL (Edit Lower) editing command before 
entering the text you want to insert in lowercase. The EL com- 
mand instructs the system to accept all characters typed as 
they appear on the keyboard. The monitor facility, which con- 
verts all alphabetic characters to uppercase, is disabled. In ad- 
dition, the characters are echoed on the terminal printer or 



-^1.^-- - xtI \r\-^TTa,-v*r\ryc^e^ nV\f 

OV.'X OC/J.J. CLS3 \A.^^'GX\^CKiDS:^ C«.i.J.VX l.\J yw^i-S^lXiDXii K^XLC 



pet Tii-»'r\«iv»r»r» c«.ni O"* 



.i. OLUL<<C;± O. 



Open the file DECIND.USA again, and type the EL command: 
Long and Short Command Format 



.EDIT 

■»E 

* 



DECIND.USA® 
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Once you have tj^ed the EL command, you can use the SHIFT 
key on the terminal to designate uppercase, just as you do on a 
typewriter. Editing commands may be entered as either upper- 
case or lowercase characters. For example, type the following 
commands, which change the characters in the first line of the 
file DECIND.USA to uppercase and lowercase: 



♦ rIDblsclilDisc) 

WE HOLD THESE TRUTHS TO BE SELF-EU IDENT » 

♦KlEliWe hold these truths to be self-eyident>( 

We hold these truths to be self-euident» 



The uppercase and lowercase capability is useful for reports, 
memos, and other textual material that you list on 
uppercase/lowercase devices. However, all characters are 
printed as uppercase if you list the file on a line printer or 
terminal that does not have the uppercase/lowercase capability. 

If at any time you want to revert to strictly uppercase editing, 
tj^e the EU (Edit Upper) command: 



Edit Upper 



»eu 



Uppercase editing is a default mode. Whenever you open a file 
for editing or create a new file, you must enter the EL command 
if you want to use the uppercase/lowercase capability. 

Close the file DECIND.USA by typing: 



*E 



EDIT filespec 

Activate the editor and open the file for editing. 

EDIT/CREATE filespec 

Activate the editor and create a new file. 



SUMMARY: 

EDITING 

COMMANDS 



Control Commands 

CTRL/L 

Insert a form feed. The form feed character is used to delimit 
pages of text in a file (introduced as part of text by the Insert 
command). 

CTRL/X 

Ignore all commands in the current editing command string. 
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Command Arguments 



n( + or -) 

An integer value between -16383 and + 16383 that sets the 
range of a command's actions based on the pointer's current 
position. 



Beginning of the current Hne (the line containing the 
pointer). 

/ 

End of the text in the text buffer. 



Input/Output Commands (pointer is not repositioned) 
(x indicates that an argument can be used) 

EX 

Exit; terminate editing, transfer the contents of the text 
buffer and the remainder of input file to the output file; close 
input and output files; return to monitor command mode. 

xL 

List; list, from the pointer, x lines of text. 

xN 

Next; write the contents of the text buffer to the output file, 
clear the text buffer, and read into it the next page from the 
input file; perform this write/read sequence x times. 

V 

Verify; list the current line (the line containing the pointer) 
on the terminal. 

Pointer Location Commands (pointer is repositioned) 
(x indicates that an argument can be used) 

xA 

Advance; move the pointer to the beginning of the xth line 
from the current pointer position. 

B 

Beginning; move the pointer to the beginning of the text 
buffer. 

xJ 

Jump; move the pointer forward or backward by x characters. 
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Text Modification Commands (pointer is repositioned) 
(x indicates that an argument can be used) 

xD 

Delete; erase x characters to the right (or left) of the pointer. 

I text (ESC) 

Insert; insert text into the text buffer at the present pointer 
position. 

xK 

Kill; erase x lines of text, beginning at the pointer. 

Search Command (pointer is repositioned) 
(x indicates that an argument can be used) 

xG text 

Get; search the text buffer, beginning at the pointer, for the 
xth occurrence of the indicated text string and leave the 
pointer at the end of the text string. 

Uppercase/Lowercase Commands (pointer is not affected) 



EL 



Edit Lower; accept characters typed at the keyboard as 
uppercase/lowercase . 



EU 



Edit Upper; revert to uppercase editing (after EL). 



If your system configuration includes VTll display hardware, 
there are several advantages to your using it during editing.^ 
First, the graphics screen becomes a window into the text 
buffer, exposing twenty lines of text at a time: the current line, 
the ten lines preceding it, and the nine lines following it. 
Figure 5-2 illustrates this format. As you edit, the lines in view 
shift to conform to the current line. In addition, the pointer is 
visible and appears as a blinking, L-shaped cursor. Its position 
is automatically adjusted as you execute editing commands. Fi- 
nally, the four lines at the bottom of the screen display the last 
three command lines plus the current command line. Hori- 
zontal dashes separate the text of the file from your commands. 



USING A 

GRAPHICS DISPLAY 

TERMINAL 

DURING EDITING 



^If your system does not have VTll display hardware, skip to the next sec- 
tion, entitled Creating the Demonstration Programs. 
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10 PRECEDING 
LINES OF TEXT 



(CURRENT LINE) 

AND 9 
FOLLOWING 
LINES OF TEXT 



SEPARATION 
LINE 




lUft 



3 PRECEDING 
COMMAND LINES 
CURRENT _ , 
COMMAND LINE "^ 



cn. 



i^msr 



ijtSlrli lb- 



JkL 1 I (1 

If l(»L ) < Ui Ik <■ 



f mT m *(frU» 






j^gtjjjj* XBiiLitf c^_T!?pL-ir." - 



WINDOW 
) INTO THE 
TEXT BUFFER 



J 



Figure 5-2 Text Window Format 



Normal Use of the 
Graphics Display 



All editing commands and functions described so far can be 
used when the graphics screen is enabled. The only difference is 
that terminal I/O is rearranged on the screen as shown in 
Figure 5-2. Note that the L and V editing commands become 
superfluous since the pointer is always displayed on the screen. 
Also, since twenty lines of text are always displayed, any List 
command within that range is unnecessary. 

Currently, your graphics screen is not enabled. To enable it, use 
the monitor GT ON command as you did in Chapter 4: 

Long and Short Command Format 

• GT ON® 

Now when you use the EDIT command to activate the editor, 
the graphics screen will be rearranged as shown in Figure 5-2. 
You can use the CTRL/E command, described in Chapter 4, to 
request simultaneous I/O on the terminal printer and graphics 
screen. 



Immediate Mode 



In addition to the regular editing capability, a quick and easy 
method of ^ra'^hics editin"' called immediate mode i° Q'^oil- 
able. Immediate mode uses a simplified set of editing com- 
mands that are limited to pointer relocation and character dele- 
tion and insertion. Most of these commands are similar to the 
special CTRL commands because to type them you use the 
CTRL key in combination with another character key. How- 
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ever, the use of these particular control commands is mean- 
ingful only in the editor immediate mode. Table 5-2 lists the 
commands. 

Table 5-2 Immediate Mode Commands 



Command 



Meaning 



CTRL/N Advance the cursor to beginning of next line 

(equivalent to A). 

CTRL/G Move the cursor to the beginning of the previous 

line (equivalent to -A). 

CTRL/D Move the cursor forward by one character (equiv- 

alent to J). 

CTRLA^ Move the cursor back by one character (equiva- 

lent to -J). 

DELETE Delete the character immediately preceding the 
cursor (equivalent to -D). 

ESCAPE Return control to the editing command mode. 

double Summon immediate mode. 

ESCAPE 

Use the editor to open a new file called IMMODE.TXT: 
Long and Short Command Format 

.EDIT/CREATE IMMODE.TXT® 
# 



Now activate immediate mode. You do this by typing the ES- 
CAPE key twice in response to the editing command mode as- 
terisk. Since there are no other commands in the command line, 
the editor recognizes the double ESCAPE as an immediate 
mode command. 



ESCAPE ESCAPE 



The editor responds by printing an exclamation point in the 

\.^UJ.11111CIXXU. jjyjl LXt-IXl UX UXIC OV^X CCXX, bXXC 1 

that you are using immediate mode. 



\.,uxxxxxxa.xxu. pux lxuxx ux i/xxc oi^xccxx, bxxc CAi;xaxiiatxuli puilllj SJlglllims 



Character insertion is the default operation and occurs when- 
ever you type a character other than one of the immediate mode 
commands listed in Table 5-2. 



Character insertion 
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The next several paragraphs demonstrate the use of the imme- 
diate mode commands on a selected portion of text. Remember 
that all characters you type that are not immediate mode com- 
mands are treated as input. Commands do not echo on the 
graphics screen, so all you ever see is the current text file. Tjnpe 
the following: 



TO BE » DR NOT TD BE - THAT IS THE QUESTION!® 

WHETHER 'TIS NOBLER IN THE MIND AND HEART TO SUFFE 

THE SLINGS OF OUTRAGEOUS FORTUNE® 

OR TO TAKE ARMS AGAINST A SEA OF TROUBLES*® 

AND BY OPPOSING END THEM?® 



CTRL/G 



As you can see on the graphics screen, the cursor (pointer) is 
positioned at the beginning of a new line. CTRL/G, equivalent 
to -A in standard editing, moves the cursor to the beginning of 
the previous line; the cursor is repositioned immediately. Type: 



(CTRL/G 1 
(CTRL/G 1 
(CTRL/G 1 



The cursor has moved backward three lines, one line for each 
CTRL/G command, and is positioned before the line: 

THE SLINGS OF OUTRAGEOUS FORTUNE* 



CTRL/V 



CTRL/V, equivalent to -J, moves the cursor back one character. 
Move the cursor back over the carriage return and line feed at 
the end of the previous line by t5rping the CTRL/V command 
eleven times (remember, the carriage return and line feed 
count as two characters): 



ICTHL/V ) 



(eleven [11] times) 



DELETE 



CTRL/N 



WHETHER 'TIS NOBLER IN THE MIND AND HEART TO SUFFER 

This positions the cursor before the word TO. The command 
DELETE, equivalent to -D, deletes the character immediately 
preceding the cursor. Type the DELETE key ten times: 

dp (ten [10] times) 

WHETHER 'TIS NOBLER IN THE MIND TO SUFFER 

CTRL/N, equivalent to A, advances the cursor to the beginning 
of the next line: 



(CTRL/N 1 



THE SLINGS OF OUTRAGEOUS FORTUNE* 
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CTRL/D, equivalent to J, moves the cursor forward one charac- 
ter; type CTRL/D ten times: 



^tZS (ten [10] times) 

THE SLINGS OF OUTRAGEOUS FORTUNE* 



CTRL/D 



Next type this text (it will be inserted immediately to the left of 
the cursor): 

@AND(DARR0WS 

The text on the screen should now look as follows: 



TO BE OR NOT TO BE - THAT IS THE QUESTION) 
WHETHER 'TIS NOBLER IN THE MIND TO SUFFER 
THE SLINGS AND ARROWS OF OUTRAGEOUS FORTUNE* 
OR TAKE ARMS AGAINST A SEA OF TROUBLES* 
AND BY OPPOSING END THEM? 



Check your results and correct any other mistakes you may 
notice. 

To return to the standard editing command mode, type a single 
ESCAPE. 



ESCAPE 



This ESCAPE command does not echo on the screen. Notice 
that the exclamation point immediately disappears and the text 
window format returns; an asterisk appears immediately below 
the exclamation point on the screen. 

You use immediate mode only to create and edit text. Opera- 
tions that move text in and out of the text buffer must be done 
with standard editing commands. 

You do not need to save the text you have just created, so use 
the CTRL/C command and two ESCAPES to return control di- 
rectly to monitor command mode. As mentioned before, EDIT 
requires this unusual command combination to prevent an acci- 
dental CTRL/C from killing your text. 

(CTRL/C) (ES5)[ESC) 



CTRL/C ESCAPE 
ESCAPE 



Following are two demonstration programs. One is written in 
the FORTRAN IV programming language and one is written in 
the MACRO-11 assembly language. Both programs are used in 
later chapters of this manual, and both contain intentional mis- 
spellings and errors. 



CREATING THE 

DEMONSTRATION 

PROGRAMS 
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Use the editor to create these programs. Type them exactly as 
they are shown, including errors. Use tabs and spaces to format 
each line as shown (remember that tab stops are positioned 
every eight spaces across the terminal page). Make sure that 
the FORTRAN IV program is formatted properly so that a 
source comparison described in the next chapter will operate 
properly. Except for the comment lines (those beginning with a 
C) and the lines that begin with a number, begin all lines with 
a tab. Use any of the editing commands described in this 
chapter. Activate the display editor and immediate mode if you 
wish. 

When you have finished, check each file carefully. The two files 
should match those shown here exactly, including tabs and 
spaces. Correct any errors that you find that are not inten- 
tional. Obtain a listing of each file by using B (Hcl/L (esc)® 
before closing the file. 

Create the FORTRAN IV file first. Call it GRAPH.FOR and use 
the system volume for storage. Then create the MACRO-11 
program. Call it SUM.MAC and again use the system volume 
for storage. 

NOTE 

Knowledge of the FORTRAN IV and MACRO-1 1 lan- 
guages is not necessary to create these demonstration 
programs. 

The following program, GRAPH.FOR, is the FORTRAN IV 
demonstration program. 

C GRAPH.FOR VERSION 1 

THIS PROGRAM PRODUCES A PLOT ON THE TERMINAL 

C OF AN EXTERNAL FUNCTION. FUN(X.Y) 

C THE LIMITS OF THE PLOT ARE DETERMINED BY THE DATA STATEMENTS 

C "STAB" IS FILLED WITH A TABLE OF WEIGHT FLAGS 

C "STRING" IS USED TO BUILD A LINE OF GRAPH FDR PRINTING 

SCAL(ZMIN,ZMAX,MAXZ.K)=ZMIN+FL0AT(K-1 )♦( ZMAX-ZMIN ) /FLOAT ( MAXZ- 1 ) 

LOGICAL*! STRING( 13.3) iSTAB( 100) 

DATA XMIN.XMAX .MAXX/-5i5 .45/ 

DATA YMIN.YMAX .MAXY/-5 iS,72/ 

DATA FMIN.FMAX/0. 0.1.0/ 

CALL SCOPY('- 123a5G7B9 +'.STAB) 

MAXFLEN(STAB) 

DO 20 IX=1 .MAXX 

X=SCAL(XMIN,XMAX,MAXX,IX) 
CALL REPEAT( '♦' .STRING. MAXY) 
IF(IX,EQ,1 ,0R. IX. EQ. MAXX) GOTO 20 
DO 10 IY=2.MAXY-1 

Y=SCAL(YMIN,YMAX.MAXY.IY) 

IFUN = 2+INT(FLaAT<MAXF-3)*(FUN(X .Y ) -FMIN ) / ( FMAX-FMIN ) ) 
10 STRING (IY)=STAB(MIN0(MAXF.MAX0(1 ,IFUN) ) ) 

30 CALL PUTSTRING(7 .STRING. ' ') 

CALL EXIT 
END 

FUNCTION FUN(XiY) 

R=SQRT(X*»2+Y»*2) 

FUN=X»Y»R»EXP(-R) )»*2 

RETURN 

END 
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The following program, SUM.MAC, is the MACRO-11 demon- 
stration program. 



.TITLE SUM.MAC VERSION 1 
.MCALL .TTYOUT. .EXIT, .PRINT 



70. 



!N0. OF DIGITS OF 



TO CALCULATE 



'E' = THE SUM OF THE RECIPROCALS OF THE FACTORIALS 
1/0! + 1/1! + 1/2! + 1/3! + 1/a! + 1/5! + ... 



EXP: 


.PRINT 


«MESSAG 




Moy 


»N ,RS 


FIRST: 


MOV 


»N+1 iRO 




MOV 


• AiRl 


SECOND: 


ASL 


SRI 




MOV 


BRl ,-(SP) 




ASL 


I5R1 




ASL 


SRI 




ADD 


(SP)+,(R1) 




DEC 


RO 




BNE 


2ND 




MOV 


• N.RO 


THIRD: 


MOV 


-(Rl) ,R3 




MOV 


«-l ,R2 


FOURTH: 


INC 


R2 




SUB 


R0,R3 




BCC 


FOURTH 




ADD 


R0.R3 




MOV 


R3,eRl 




ADD 


R2-2(R1) 




DEC 


RO 




BNE 


THIRD 




MOV 


-(Rl) ,R0 


FIFTH: 


SUB 


«10. ,R0 




BCC 


FIFTH 




ADD 


«10+'0,R0 




.TTYON 






CLR 


I9R1 




DEC 


R5 




BNE 


FIRST 




.EXIT 




EXP: 


.REPT 


N+1 




.WORD 


1 




.ENDR 





PRINT INTRODUCTORY 
NO. OF CHARS OF 'E 
NO, OF DIGITS OF A 
ADDRESS OF DIGIT V 
DO MULTIPLY BY 10 
SAVE *2 

*a 

♦ S 

NOI.) ♦10, POINT TO 
AT END OF DIGITS? 
BRANCH IF NOT 
GO THRU ALL PLACES 
BY THE PLACES INDE 
INIT QUOTIENT REGI 
BUMP QUOTIENT 
SUBTRACT LOOP ISN 
NUMERATOR IS ALWAY 
FIX REMAINDER 
SAVE REMAINDER AS 
FOR NEXT DIGIT 
GREATER INTEGER CA 
TD GIVE DIGIT 
AT END DF DIGIT VE 
BRANCH IF NOT 
GET DIGIT TO OUTPU 
FIX THE 2.7 TO .7 
THAT IT IS ONLY 1 
(REALLY DIVIDE BY 
MAKE DIGIT ASC II 
OUTPUT THE DIGIT 
CLEAR NEXT DIGIT L 
MORE DIGITS TO PRI 
BRANCH IF YES 
1.IE ARE DONE 



TEXT 
TO PRINT 
CCURACY 
ECTOR 
(DECIMAL) 



NEXT DIGIT 

DIVIDING 
X 
STER 

T BAD 

S < 10*N 

BASIS 

RRIES 

CTOR? 

T 

SO 

DIGIT 
10) 



OCATION 
NT? 



!INIT VECTOR TO ALL ONES 



MESSAG: .ASCII /THE VALUE OF E IS:/ <15><12> /2./ <200> 
.EVEN 

.ENDEXP 



When you have created and checked these two programs, ob- 
tained listings, and stored them as files on your system volume, 
go on to Chapter 6, Comparing Text Files. Chai^ter 6 demon- 
strates a proofreading aid that helps you evaluate your editing 
ability. 



RT-11 System User's Guide (AA-5279C-TC). Maynard, Mass.: Digital Equip- 
ment Corporation, 1983. 

A guide to the use of the RT-11 operating system. 



REFERENCE 
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CHAPTER 6 
COMPARING TEXT FILES 



The RT-11 operating system provides a proofreading aid, called 
a source comparison, to help you quickly establish the differ- 
ences between two ASCII text files. During a source compar- 
ison, the system compares the two files, character for character, 
and prints on the terminal (or line printer) any lines that con- 
tain differences. 

Usually, you perform a source comparison against two files that 
you expect to be the same, or at least similar. For example, if an 
individual has copied one of your files to make changes to it, 
you can quickly scan the changes by performing a source com- 
parison between the new version and your original. Another 
use of a source comparison is to check edits you have made to a 
file yourself. By comparing the backup file against the edited 
version, you can proofread the changes since only the portions 
of text that are different are printed. 

In this chapter, you will use source comparisons to find editing 
errors that may exist in the demonstration programs 
(GRAPH.FOR and SUM.MAC) that you created in Chapter 5. 
These dem-onstration programs contain intentional misspell- 
ings and misplaced text that you must correct before the pro- 
grams can be used in later demonstrations. On your system 
volume is a counterpart of each file. These counterparts are 
provided as part of the RT-11 operating system so that you can 
use them to perform a source comparison against your own ver- 
sions. Essentially, the counterpart programs have been carried 
one step further in the editing process than your own; they 
contain no editing errors. Therefore, when you compare them 
against your versions, the printed list of differences will reflect 
the typing errors that still exist in your versions — some of 
these errors are intentional; others you may have inadvertently 
introduced during editing. All must be corrected before you can 
use the programs. 

The monitor ^ommand used to compare two text files is the PERFORMING A 

DIFFERENCiiS command. When you type this command on COMPARISON 

the terminal, it activates the RT-11 utility program called 

SRCCOM.SAV, which is part of the RT-11 operating system 

stored on the system volume. The system prompts you for the 

input file names. Respond to the input prompts with the names 

of the files you want to compare; the default storage volume is 

the system volume. The output will be sent to the terminal, 

which is the default device for output. 



6-1 



Comparing Text Files 



DIFFERENCES 



The programs that you created in Chapter 5, SUM.MAC and 
GRAPH. FOR, have their respective counterparts, 
DEMOXl.MAC and DEMOFl.FOR, on the system volume. Use 
the DIFFERENCES command to compare the MACRO-11 
(.MAC) files first. The /MATCH option indicates the number of 
lines that determine a "match", explained in a moment.^ 

Long Command Format 

.DIFFERENCES/MATCH! 1 ESI 
File 1? DEMOXl.MAC® 
File 2? SUM.MAC(al) 

Short Command Format 

.DIFFERENCES/MATCH: 1 DEMOXl.MAC SUM.MAC® 

The list of differences printed on your console terminal should 
be similar to the following example. It will show all the differ- 
ences listed here, plus any others that you may have introduced 
yourself during editing. 

Notice the format of the list. Individual sections are marked 
with the letters A, B, C, and D to help you become acquainted 
with the format. A description follows the list, and you should 
refer to it as you study the list. 



A 1) DK 


DEMDXl.MflC 






A 2) DK 


SUM. 


MAC 






»**«♦»♦««* 








GDI 




.TITLE 


EXAMP.MAC 


(VERSION PROVIDED) 


1) 










D 1) 




.MCALL 


.TTYOUT. .EKIT. 


.PRINT 


B *«** 










C 2)1 




.TITLE 


SUM.MAC VERSION 


1 


2) 










D 2) 




.MCALL 


.TTYOUT, .EXIT. 


.PRINT 


*««***♦*»♦ 








C 1)1 




BNE 


SECOND 


iBRANCH IF NOT 


D 1) 




Moy 


SN.RO 


■GO THRU ALL PLACES, 
iDIVIDING 


B ***♦ 










C 2)1 




BNE 


2ND 


iBRANCH IF NOT 


D 2) 




Moy 


»N,RO 


iGD THRU ALL PLACES , 
iDIVIDING 


********** 








C 1)1 




ADD 


«10+'0.R0 


iMAKE DIGIT ASCII 


D 1) 




.TTYON 




iOUTPUT THE DIGIT 


B ***« 










C 2)1 




ADD 


»10+'0,R0 


iMAKE DIGIT ASC II 


D 2) 




.TTYON 




iOUTPUT THE DIGIT 


♦««**«♦♦#« 








C 1)1 




.END 


EXP 




B ♦*♦* 










C 2)1 




.ENDEXF 






♦*»♦«***«♦ 








7BRCC0M-W- 


Files are diffe rent 





^Users of display hardware may wish to enable both the graphics screen and 
the terminal printer by first typing the CTRL/E command. 
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The first two lines identify the two files that are being com- 
pared. The file name and the device on which the file resides 
are printed. Also, the numbers 1) and 2) are assigned to the 
files (see lines labeled A in the example list above). 

The first difference that is listed occurs in the title line of the 
program. Usually differences that occur in these two lines are 
intentional and reflect information that is unique to each file, 
such as name and file type, version or edit number, and perhaps 
date of creation. 

The numbers that appear at the left margin of the list further 
identify the files. For example, 1)1 indicates the first page of 
the first file and 2)1 indicates the first page of the second file. 

The lines of both files are compared character for character. 
Blank lines are ignored, but all other characters, including tabs 
and spaces, are compared. When two lines are found to be dif- 
ferent, the system prepares a difference section, which it subse- 
quently prints (see lines labeled B). 



The system prepares the difference section as follows. When it 
finds two lines that are different, it notes the page number and 
records the lines (see lines labeled C). Next it searches for a 
match. A match is a certain number of lines in each file that 
are exactly the same. Since you specified a match of 1 in the 
/MATCH:n option (/MATCH: 1), the system in this case searches 
for a single line in each file that is exactly the same. When the 
system finds a match, it records the last line of the match for 
identification purposes (see lines labeled D). Then it prints the 
difference section and repeats the process, preparing a subse- 
quent difference section if more differences exist. Individual dif- 
ference sections are separated from each other by a long row of 
asterisks, while the short rows of asterisks separate the lines of 
the first file from those of the second. 

A message is printed following the comparison. Files are dif- 
ferent is printed if differences exist; No differences found is 
printed if the files are the same. 

Check the list printed on your terminal to find the errors the 
system detected. Mark each error on the listing of SUM.MAC 

UXXL4.U J\J\A. V/fLf udXi-iOVI. XiX V-'J.J.OLJk/U'CJ. «J. 

Now perform a source comparison between the FORTRAN IV 
files, DEMOFl.FOR and GRAPH.FOR. 

Long Command Format 

.DIFFERENCES/MATCH! l(aD 
File 1? DEMOFl.FORdS) 
File 2? GRAPH.FOR® 



DIFFERENCES/ 
MATCH :n 
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Short Command Format 

.DIFFERENCES/MATCH! 1 DEMOFl.FOR GRAPH. FDRSB 

1) DKiDEMOFl.FOR 

2) DK:GRflPH.FOR 
♦*♦♦**«♦#« 

1)1 C EXflMP.FOR (yERSIGN PROyiDED) 

1) C THIS PROGRAM PRODUCES A PLOT ON THE TERMINAL 
»»*♦ 

2)1 C GRAPH. FOR VERSION 1 

2) C THIS PROGRAM PRODUCES A PLOT ON THE TERMINAL 
♦««»***«*♦ 

1)1 C "STAB" IS FILLED WITH A TABLE OF HEIGHT FLAGS 

1) C "STRING" IS USED TO BUILD A LINE OF GRAPH FOR PRINTING 
»♦«« 

2)1 C "STAB" IS FILLED WITH A TABLE OF WEIGHT FLAGS 

2) C "STRING" IS USED TO BUILD A LINE OF GRAPH FOR PRINTING 
**♦««♦»♦«* 



1)1 




MAXF=LEN(STAB) 


1) 




DO 20 IX=1 iMAXX 


«**♦ 






2)1 




MAXFLEN(STAB) 


2) 




DO 20 IX=1 ,MAXX 


«»»»♦#«»«« 




1)1 


30 


CALL PUTSTR(7. STRING,' ' 


1) 




CALL EXIT 


*»*♦ 






2)1 


30 


CALL PUTSTRING<7, STRING, 


2) 




CALL EXIT 


#♦♦»#♦*♦»« 




7SRCC0M- 


-W-Files 


are different 



Similarly, mark the errors on the listing of GRAPH.FOR that 
you obtained in Chapter 5. 

Now return to the section entitled Editing a Text File in 
Chapter 5. Review the editing commands described there and 
the summary at the end of the section. Use the appropriate 
commands to correct the files SUM.MAC and GRAPH.FOR. 
When you have finished editing, perform the source compari- 
sons again against DEMOXl.MAC and DEMOFl.FOR. If you 
have edited the files correctly, the comparison finds differences 
only between the first lines of each program. The following 
messages should print on your console: 

.DIFFERENCES/MATCH:l@a) 

File 1? DEMOFl.FOR® 

File 2? GRAPH. FORdU 

1) DKsDEMOFl.FOR 

Z) DKsGRAPH.FOR 

********** 

1)1 C EXAMP.FOR (VERSION PROVIDED) 

1) C THIS PROGRAM PRODUCES A PLOT ON THE TERMINAL 
**** 

2)1 C GRAPH.FOR VERSION 1 

2) C THIS PROGRAM PRODUCES A PLOT ON THE TERMINAL 
********** 

?SRCCOM-W-Fi les are different 

and 
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.DIFFE.RENCES/MATCHs 1 
File 1? DEMDXl .MAC® 
File 2? SUM. MAC® 

1) DK:DEMDX1 .MAC 

2) DK:SUM,MAC 
********** 
1 ) 1 
1) 
1) 

**** 
2) 1 
2) 
2) 
********** 

?SRCCOM-W-Fi les are different 



.TITLE EXAMP.MAC (yERSION PROUIDED) 

.MCALL .TTYOUT. .EKIT» .PRINT 

.TITLE SUM. MAC UERSIDN 1 

.MCALL .TTYDUT, .EXIT* .PRINT 



These messages indicate that a difference exists in the first line 
of each program. However, no other differences were found in 
the programs during the comparison. Thus, your programs are 
ready for use in later demonstrations, and you know how to 
create and edit programs. 

If differences still exist in your files and you cannot resolve 
them by editing, you may continue to the next chapter if you 
wish. However, you need practice editing, and it is to your ad- 
vantage to rework the examples in both Chapter 5 and this 
chapter. 



DIFFERENCES 

List the differences between two ASCII text files. 

DIFFERENCES/MATCHm 

Indicate the number of lines (n) to determine a match; the 
default number is 3. 



SUMMARY: 

COMPARISON 

COMMAND 



RT-ll System User's Guide (AA-5279C-TC). Maynard, Mass.: Digital Equip- 
ment Corporation, 1983. 

A guide to the use of the RT-ll operating system. 

RT-ll System Utilities Manual (AA-M239A-TC). Maynard, Mass.: Digital 
Equipment Corporation, 1983. 

A guide to the use of the RT-ll system utilities. 



REFERENCES 
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CHAPTER 7 
PERFORMING FILE MAINTENANCE OPERATIONS 



The system volume, as it is initially supplied, contains only the 
files of the RT-11 operating system — the monitor files, the 
system device handlers, the system utility programs, and per- 
haps the language processors. Since the system volume serves 
as the default storage volume for all system operations (unless 
DK: was assigned to another volume), you will discover that it 
acquires many additional files during normal use. For example, 
files that you create with the editor are written on the system 
volume; edited files automatically create backup versions on 
the system volume; many utility programs create output and 
listing files on the system volume as part of their normal pro- 
cessing operations. By the time you finish an average session of 
computer operations, several new file names have been added 
to the directory of your system volume. Eventually your system 
volume may become full and its directory cluttered with the 
names of files for which you have no use. To avoid this you 
should perform regular housekeeping, or file maintenance, op- 
erations as you use the system. You should update and transfer 
copies of your important files to other storage volumes for safe- 
keeping and later use, and you should delete from your system 
and storage volume directories the names of files you no longer 
need. 

The RT-11 operating system provides a number of monitor 
commands for this purpose. These commands activate the 
RT-11 utility programs called PIP.SAV, DUP.SAV, and 
DIR.SAV, which are part of the RT-11 operating system stored 
on your system volume. These utility programs allow you to 
transfer and erase files. The commands used in this chapter 
show one way to maintain your system and storage volume. 
When you become more familiar with system operations and 
learn some of the commands not described here, you may prefer 
other methods. 



Before you perform operations that might move or erase files on FILE DIRECTORY 

a volume, list a directory of the volume involved. The directory OPERATIONS 

tells you the full names of files, their sizes, and whether backup 
copies exist. A directory of your system volume shows the files 
that have been added to it through normal use. 

First obtain a directory of your system volume (as you learned 
in Chapter 4), using the appropriate command to list it on ei- 
ther the terminal or the line printer. The directory is relatively 
long; let it list to completion. 
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Long and Short Command Format 

(Line printer) 



.DIRECTORY/PRINTE 



(Terminal) 



.DIRECTORY!! 



At the end of the system volume directory you should see sev- 
eral additional entries. These files are the result of the system 
operations you have performed so far: 



DECIND 


.USA 


1 


8-JAN-83 


DECIND 


.BAK 


1 


8-JAN-83 


GRAPH 


.FOR 


2 


8-JAN-83 


GRAPH 


.BAK 


2 


8-JAN-83 


SUM 


. MAC- 


3 


8-JAN-83 


SUM 


.BAK 


3 


8-JAN-83 



Next list a brief directory of your storage volume. This direc- 
tory should be empty (void of any file names or file types) be- 
cause you initialized it in Chapter 4. 

Long and Short Command Format 

(Line printer) 

.DIRECTORY/BRIEF/PRINTER UOLi® 

(Terminal) 

.DIRECTORY/BRIEF UOLs® 

These directories give you the information you need for erasing 
and copying files. For example, you know the additional files 
that are now on your system volume, and you know that since 
the directory of the storage volume is empty, there is ample 
room on it for new files. 



mULi iPl_E PiLc 



You often have occasion to perforrn the same utility operation 
on several iiies. r or exampxe, you may copy from one volume to 
another all files with the file type .MAC, or you may erase from 
a volume all files with the name TEST. Rather than perform 
the required operation on the files one at a time, it is easier to 
use the wildcard construction, a shorthand method provided by 
the RT-11 operating system. Wildcard construction allows you 
to substitute an asterisk (*) or percent sign (%) for a portion of 
the file name that is variable among all the files you want used 
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in the operation. For example, specifying DECIND.* in a com- 
mand causes the operation to act on all files with the file name 
DECIND, regardless of their file type; *.BAK causes the system 
to act on files with the file type BAK, regardless of their file 
name. Specifying TEST%.FOR causes the operation to act on all 
files having a type of FOR, starting with the four characters 
TEST, and having any fifth character (for example, 
TESTA.FOR, TESTl.FOR, etc.). 

A special use of the wildcard construction involves substitution 
of an asterisk for both file name and file type. *.* implies that 
all files, regardless of the file name or file type, are to be used 
in the operation. 

Exercises in this chapter and throughout the remainder of the 
manual demonstrate various uses of the wildcard construction. 



Storage volumes provide an area where you can store important 
files. Since most files are originally created on the default sys- 
tem volume, you must copy them from the system volume to the 
storage volume. The following exercises show you how to make 
backup copies on your storage volume of the two provided dem- 
onstration programs (DEMOFl.FOR and DEMOXl.MAC), and 
how to copy to the storage volume the two programs you cre- 
ated (GRAPH.FOR and SUM.MAC). 

The monitor command that copies files between volumes is the 
COPY command. This command instructs the system to dupli- 
cate the file that you indicate as input, and then gives the new 
file the name and file type that you specify as output. The origi- 
nal version of the file is unaffected; that is, a copy of the origi- 
nal version is made and moved to the new volume. 

To copy GRAPH.FOR to your storage volume under the new 
name GRAPH.TWO, type: 



FILE COPYING 
OPERATIONS 




Long Command Format 

.COPYEl 

From? GRAPH. FORESI 

To ? MOL: GRAPH. TNOlE) 



(System volume is 
assumed for input.) 



Short Command Format 



.COPY GRAPH.FOR MOL:GRAPH.TW 



The system makes a copy of the file GRAPH.FOR on the stor- 
age volume and gives the copy the name GRAPH.TWO. When 
the operation is complete, the monitor prints a period at the left 
margin and waits for you to enter the next command. This 
time, copy SUM.MAC to the storage volume. 



7-3 



Performing File Maintenance Operations 



Long Command Format 

.COPY® 

From? SUM.MACdEI 

To ? MOL:SUM,MAC® 



Short Command Format 

.COPY SUM. MAC UOLiSUM.MACdl) 



The system copies the file SUM.MAC to your storage volume 
and gives the copy the name SUM.MAC. 

Now, copy the two provided demonstration programs, 
DEMOFl.FOR and DEMOXl.MAC, to the storage volume. 



Long Command Format 

.COPYO 

From? DEMOFl .FOR® 

To ? VOLsDEMOFl .FOR®) 

.COPY® 

From? DEMOXl .MAC® 

To ? MOL: DEMOXl .MAC® 



Short Command Format 

.COPY DEMOFl.FOR UOL : DEMOFl . FOF 
.COPY DEMOXl.MAC UOL s DEMOXl . MAC® 



A directory of your storage volume should verify that it now 
contains these four files. ^ 



Long and Short Command Format 



.DIRECTORY MOL:® 

08-Jan-83 
GRAPH .TWO 2 08-Ja)-i-B3 
DEMOFl.FOR 2 2B-Au3-82 

a Files* 10 Blocks 

4752 Free blocks 



SUM .MAC 3 
DEMOXl.MAC 3 



08-Jan-B3 
2S-AUS-82 



FILE RENAMING 
OPERATIONS 



The directory you just listed shows that you copied the GRAPH 

demonstration file to your storage volume under a new file 

type, .TWO. Assume you did not intend to copy it using a new 
K^n +T7-»>^ r^^A ■^^■,-., <.t;^u 4-1,^+ 4j- ,„„„« „„„: ] ij._ _..;_^ 1 xri. 

j.j.±t; ujpc aiiu. iiuYV vvj-axi Liiau lu wcxc aosiglicu ILiS ungllia.1 llltJ 



''If you are using magtape as your storage volume, read the section entitled 
Directory vs Nondirectory-Structured Volumes in Appendix B. 
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type, .FOR. Use the monitor RENAME command to rename the 
file already on the storage volume.^ 

Long Command Format 

♦ RENAME® 

From? MOLsGRAPH.TWO®) 

To ? UOL: GRAPH. FOR® 

Short Command Format 

.RENAME yOL:GRAPH.TWO MOL : GRAPH . FOR® 

The RENAME command simply changes the file name or file 
type of a file in the volume directory without altering or mov- 
ing the file itself. When you perform a rename operation, the 
volume indicated in the input and output portions of the com- 
mand must be the same; otherwise a system message is printed. 

Rename the file copies DEMOXl.MAC and DEMOFl.FOR 
presently on your storage volume to EXAMP.MAC and EX- 
AMP.FOR respectively. 

.RENAME UOLiDEMOXl.MAC VOL : EXAMP . MAC® 
.RENAME MOLiDEMOFl .FOR UOL : EXAMP . FOR® 

Again list a directory of your storage volume to verify that the 
renaming operation occurred. 

Long and Short Command Format 



RENAME 



.DIRECTORY VOL:® 








08-Jan-83 








GRAPH. FOR 2 OB-Jan-83 


SUM .MAC 


3 


08-Jan-83 


EXAMP.FOR 2 2B-Au3-82 


EXAMP.MAC 


3 


2G-AL19-82 


4 Files > 10 Blocks 








4752 Free blocKs 









Once copies of your important files are stored on a storage vol- 
ume, you can delete from the system volume — or any other 
volume — those files that you no longer need., The file deletion 
operation removes information about the file from the volume's 
directory; the space that the file occupies on the volume be- 
comes available for reuse. Files that you want to delete gener- 
ally include .BAK files created during editing, temporary files 
created by utility programs, or any other unnecessary files. 



FILE DELETION 
OPERATIOMS 



"•Magtape users cannot use the RENAME command and should read the sec- 
tion entitled Alternate Rename Operation for Magtape Users in Appendix B. 
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DELETE 



Now that you have copies of your important files, you can de- 
lete several files from your system volume. For example, you 
can delete all files with a .BAK file type created as a result of 
editing. You can delete the file DECIND.USA, since this was 
created only for editing practice. Finally, you can delete the 
files GRAPH.FOR and SUM.MAC, since copies of these are now 
on VOL:. 

Do not delete DEMOFl.FOR and DEMOXl.MAC from your 
system volume, even though copies of these are also on VOL:. 
You should consider these two files as part of the RT-11 opera- 
ting system, and therefore should not erase them from the sys- 
tem volume. These copies can serve as additional backups for 
the files on the storage volume. 

The monitor DELETE command is used to delete file names 
from a volume. You can specify as many as six input files for 
deletion. 



Long Command Format 

• DELETEdSl 

Files? DECIND.USA (GRAPH.FOR (SUM.MACtES) 

Short Command Format 

.DELETE DECIND.USA (GRAPH.FOR (SUM.MACES) 

If wildcard construction is used or if the /QUERY option is spec- 
ified, the DELETE command requests confirmation from you by 
printing each file name on the terminal before it deletes it. If 
you tjTje a Y response, the system deletes the file, while an N 
response instructs the system to ignore that file and go on to 
the next. Notice how you use the wildcard construction in the 
input file to delete all files with a .BAK file ty^e. 



Long Command Format 



.DELETEiB 
Files? ».BAK(iS) 

Files deleted: 
DKiDECIND.BflK ? YiB 
DK:SUM.BflK ? Y(H) 
DKsGRftPH.BflK ? YSB 



.DELETE/OUERYffl) 

Files? GRAPH, BftK .SUM. BAK .DECIND.BAKS 

Files deleted: 
DK:DECIND,BAK ? YEB 
DK:SUM.BAK ? YfiB 
DK:GRAPH.BAK ? YBH) 






.DELETE *.BAK(aHI 
Files deleted: 
DK:DECIND.BAK ? Y(BI) 
DK:SUM.BAK ? YfiB 
DK:GRAPH.BAK ? Y(EI 



.DELETE/OUERY GRAPH. BAK .SUM. BAK .DECIND . BAKIj 

Files deleted: 
DK:DECIND.BAK ? Y(E) 
DK:SUM.BAK ? Y(aB) 
DK:GRAPH.BAK ? YEB 
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You can give a file a protected status to prevent it from being 
deleted from the volume it resides on. A file that has a pro- 
tected status cannot be deleted until that status is removed. 

The files DEMOFl.FOR and DEMOXl.MAC should still be on 
your system volume. These files must not be deleted because 
they are part of your RT-11 operating system. You can give 
these two files a protected status to ensure that they are not 
accidentally deleted. 

The monitor PROTECT command is used to give files a pro- 
tected status. You can specify up to six input files (separated 
with commas) with this command. As with the DELETE com- 
mand, if you use the wildcard construction or specify the 
/QUERY/ option, the RT-11 system requests confirmation be- 
fore protecting each file. 

Use the PROTECT command to give the files DEMOFl.FOR 
and DEM0X1.MAC a protected status. 

Long Command Format 

.PROTECT® 

Files? DEMOFl .FOR tDEMOXl .MAC® 

Short Command Format 

.PROTECT DEMOFl.FOR. DEMOXl.MAC® 

List a directory of these two files and notice the "P" next to the 
number of blocks in the second column. 

Long and Short Command Format 



FILE PROTECTION 
OPERATIONS 



PROTECT 



.DIRECTORY 

08-Jan-83 
DEMOXl.MAC 3P ZB-AuS-B2 

2 Files* 5 Blocks 

921 Free blocks 



DEMDFl .FOR .DEMOXl .MAC® 

DEMOFl.FOR 



2B-AU3-82 



The UNPROTECT command removes a file's protected status 
so that the file can be deleted. You can determine whether a file 
is protected or not by listing the directory. If a file is protected, 
a "P" will appear next to the block size number of the file's 
directory entry. You can specify up to six input files (separated 
with commas) with this command. As with the DELETE com- 



Irt TT XTT-I 1 #-| ^» *^ -V.^ 



J , :i? XT-. 



//"VTT'nTlTT- 



, J.X Tvxxu.v/axu. uuxxaux ui^uxuix xo U.C5CU UX 11 uie /V^LJU/JCVI OpLlOn 

is specified the UNPROTECT command requests confirmation 
for each file. 

Remove the protected status from the files DEMOFl.FOR and 
DEMOXl.MAC. 



UNPROTECT 
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Long Command Format 

.UNPROTECT® 

Files? DEMOFl.FDR (DEMOXl .MAC® 



Short Command Format 

.UN PROTECT DEMOFl.FOR tDEMOXl .MAC® 

Again list a directory of the two files DEMOFl.FOR and DEM- 
OXl.MAC. The "P" 's are removed from the listing, signifying 
that the files are no longer protected. 



Long and Short Command Formats 

.DIRECTORY DEMOFl .FOR >DEM0X1 .MAC® 

08-Jan-83 
DEMOXl.MAC 3 ZS-Au3-8Z DEMOFl.FOR 

2 Fi les » 5 BlooKs 

921 Free blocks 



2B-AUS-82 



FILE LISTING 
OPERATIONS 




You sometimes need a listing of a file before you can decide 
whether or not to delete it. In Chapter 5, you used the RT-11 
editor to get listings of the files you created. You can also use 
monitor commands to obtain listings of files. One command 
lists a file on the console terminal; another lists a file on the 
line printer.^ The system volume is the assumed storage volume 
for the input file. 

Type one of the following sets of commands to obtain listings of 
EXAMP.MAC and EXAMP.FOR. 



Long Command Format 

(Line Printer) 

•PRINT® 

Files? yOL:EXAMP.MAC® 

.PRINT® 

Files? MOLrEXAMP.FOR® 

Short Command Format 

(Line Printer) 



(Terminal) 



.TYPE 

Files? yOL!EXAMP.MAC(i 



.TYPE 

Files? UOLsEXAMP.FORl! 



(Terminal) 



.PRINT VOLiEXAMP.MAC® 
.PRINT MOLrEXAMP.FOF 



.TYPE yOL:EXAMP.MAC® 
.TYPE VOL:EXAMP.FOR® 



^If a line printer is available on your system, you should always use it for 
listings because of its high speed of printing. 
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You should perform file maintenance operations periodically as 
you use the system. File maintenance keeps your system and 
storage volumes up-to-date and provides maximum free space 
on volumes for new files. 



COPY 

Copy the specified file from one volume to another. 

DELETE 

Delete the specified file(s) from the volume's directory. Con- 
firmation is required before deleting the file if wildcard con- 
struction or the /QUERY option is used. 

DIRECTORY 

List the volume directory on the terminal. 

DIRECTORY/PRINTER 

List the volume directory on the line printer. 

PRINT 

List the contents of the specified file on the line printer. 

PROTECT 

Give the specified file protected status so it cannot be deleted 
until that status is removed. Confirmation is required before 
protecting the file if wildcard construction or the /QUERY 
option is used. 

RENAME 

Give a new name to the specified file. 

TYPE 

List the contents of the specified file on the terminal. 

UNPROTECT 

Remove the protected status of the specified file so that the 
file can be deleted. Confirmation is required before removing 
each file's protection if wildcard construction or the /QUERY 
option is used. 



SUMMARY: 

FILE MAINTENANCE 

COMMANDS 



RT-ll System User's Guide (AA-5279C-TC). Maynard, Mass.: Digital Equip- 
ment Corporation, 1983. 

A guide to the use of the RT-ll operating system. 



REFERENCE 
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CHAPTER 8 
CHOOSING A PROGRAMMING LANGUAGE 



Programming languages and language processors are aids pro- 
vided by the operating system to help you develop programs of 
your own. Whenever you plan to write a program, you must 
first decide on the programming language that you will use, 
since most computer systems support several. After you have 
chosen the language, you must design and code your program 
using appropriate language statements and being careful to 
follow formatting rules and restrictions. Finally, you must use 
the corresponding language processor, which is stored on the 
system volume or on a volume of its own, to convert your pro- 
gram statements into a format suitable for execution. 



Hundreds of programming languages have been developed for 
computer systems. Some languages can be used only for specific 
applications or with a particular computer system. Other lan- 
guages are general purpose; they are suitable for a variety of 
problem-solving situations and, in addition, are easy to learn 
and use. The languages demonstrated in this manual include 
two well-known and widely used high-level program.ming lan- 
guages (BASIC-11 and FORTRAN IV) and one RT-11 system- 
specific machine-level programming language (MACRO-11). 

High-level languages, like BASIC-11 and FORTRAN IV, are 
usually easy to learn and use. You write programs using lan- 
guage statements that need not deal with the specifics of the 
computer system. The language processor — and perhaps 
other utility programs as well — handles all conversions that 
are necessary for program execution. Since a single high-level 
language statement may perform several computer operations, 
and since you need not be concerned or familiar with the struc- 
ture of the computer and peripheral devices, you can concen- 
trate solely on solving the problem at hand. The language proc- 
essor takes care of translating the statements into computer 
information. 

Thus, high-level languages are considered machine-inde- 
pendent languages because language statements are such that 
any program written in the language can usually be executed 
on an entirely different computer system (that supports the lan- 
guage) with few, if any, modifications. 

Machine-level languages, on the other hand, such as the as- 
sembly language MACRO-11, require that you know about the 
computer and the peripheral devices and how they work to- 
gether. You write programs in formats that are closer to those 



HIGH-LEVEL VS 

MACHINE-LEVEL 

LANGUAGES 
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required for execution. Since a single machine-level language 
statement usually performs only one computer operation, you 
must account in your program for each computer operation that 
will be required. 

For this reason, machine-level languages are machine- 
dependent languages. The program is coded in a format that is 
not usually interchangeable among systems. Machine-level lan- 
guage programs can be efficient because the knowledgeable 
programmer will choose the fastest and most precise instruc- 
tions for getting a job done. 

Table 8-1 lists a comparison of high-level vs machine-level lan- 
guages. 

Table 8-1 Language Comparisons 



High-Level 



Machine-Level 



Easy to learn and use; no 
experience required 

Machine-independent 

Many hidden conversions 
necessary for program exe- 
cution; more computer 
memory is used 

Slower execution time 

Less efficient; the system 
makes decisions concerning 
computer operations 

Easier to debug (find and fix 
errors) 

Easier to understand pro- 
grams; functions added with 
less difficulty 



More difficult to learn and 
use; familiarity with the com- 
puter system required 

Machine-dependent 

Only direct translation is nec- 
essary for program execution; 
less computer memory is used 

Faster execution time 

More efficient; the program- 
mer makes decisions concern- 
ing computer operations 

Harder to debug (find and fix 
errors) 

Harder to understand pro- 
grams; functions added with 
greater difficulty 



Beginning programmers, students, commercial applications 
programmers, and the casual computer user prefer high-level 
languages because they are less difficult to learn and to use, 
and they produce fast results. System programmers, on the 
other hand, may prefer machine-level languages for writing 
programs (those that make up an operating system, for exam- 
ple) that must often be as fast, efficient, and concise as possible. 



8-2 



Choosing a Programming Language 

The designers of a computer system generally select program- RT— 1 1 

ming languages that will satisfy and suit the current (or per- PROGRAMMING 

haps potential) system user environment. The RT-11 computer LANGUAGES 

system is designed for use in many environments: education, 

business, laboratory, etc. Some of its applications include data 

acquisition and analysis, record keeping, control systems, and 

learning through computer simulation. RT-11 programmers 

and users include both the very knowledgeable and the 

student/beginner. 

To satisfy the varied requirements of these environments, 
RT-11 supports several programming languages: 

High-Level Machine-Level 

BASIC-11 MACRO-11 

FORTRAN IV 

DIBOL 

Whenever you choose one or more of these programming lan- 
guages for your own use, consider the following criteria: 

» What is your programming experience? What languages do 
you already know? 

® How much time do you have to learn a new language? 



a 



For what applications will you use the language? How im- 
portant are program speed and efficiency? 

9 Will you use your program on any other computer systems? 

If you are already familiar with a language supported by the 
system, you may prefer to continue using that language rather 
than spend time learning a new one. However, if you want to 
learn a language, consider your application. High-level lan- 
guages handle most programming jobs. Unless you plan to 
write extremely detailed or time-critical programs, you should 
select a high-level language. 

If you are a beginning programmer, you may prefer to start 
with a language like BASIC-11, which is a conversational, in- 
teractive language. Language statements use simple, English- 
like words and common mathematical expressions. You can re- 
quest immediate answers to problems by using the immediate 
modes of the language, or you can create detailed programs by 
combining single language statements into larger segments. 
BASIC-11 is a superset of the industry-standard BASIC devel- 
oped at Dartmouth College. Chapter 10 of this manual de- 
scribes BASIC-11 in more detail. 
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RT-11 FORTRAN IV is a superset of the industry-standard 
FORTRAN IV. This language has long been recognized for its 
use in the scientific field; in addition, it is one of the most com- 
monly supported languages across systems. You may decide to 
choose FORTRAN IV because it is a more powerful language 
than BASIC-11 or because you plan to use your programs on 
more than one system. Chapter 9 of this manual describes FOR- 
TRAN IV in more detail. 

Finally, if you are an experienced user, you may select the ma- 
chine-level programming language MACRO-11. This is a pow- 
erful language that allows user programs to access and utilize 
every possible feature available on the RT-11 computer system. 
The language requires a considerable amount of computer ex- 
perience and knowledge to be used effectively, however. The 
MACRO-11 language is best for you if you are a system pro- 
grammer or an experienced high-level language programmer. 
It is described in more detail in Chapter 11 of this manual. 



CHOOSING 
A LANGUAGE 
FOR THE 
DEMONSTRATION 



Three RT-11 programming languages are demonstrated in the 
next several chapters of this manual; FORTRAN IV, 
BASIC-11, and MACRO-11. Consider your ability as a pro- 
grammer. If you are a beginner, BASIC-11 is probably the best 
language for you to start with; FORTRAN IV is also a good 
choice. However, you need not be proficient in any of these 
programming languages to perform the exercises provided in 
this manual. 

Your particular RT-11 computer system may not provide all 
three languages. First check question 10 in the Hardware Con- 
figuration section of Chapter 2 to find out which languages are 
available on your system. 

Then select a language to continue the demonstration. If you 
choose FORTRAN IV, continue to Chapter 9. If you choose 
BASIC-11, go on to Chapter 10. If you choose MACRO-11, go 
to Chapter 11. 
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CHAPTER 9 
RUNNING A FORTRAN IV PROGRAM 



The FORTRAN IV programming language^ is a machine-inde- 
pendent programming language that was originally designed 
as a quick and easy aid for solving mathematical equations and 
formulas. However, FORTRAN IV is a powerful language and 
not difficult to learn or use, and is also well suited to many 
other kinds of applications. 



FORTRAN (FORmula TRANslation) IV is an algebraically ori- 
ented language. You write a FORTRAN IV program as a se- 
quence of language statements that combine common English 
words with quasi-algebraic formulas. You then arrange groups 
of the language statements into logical units called program 
units. One or more program units make up an entire executable 
FORTRAN IV source program. 

When you are satisfied with the logic of your FORTRAN IV 
source program, you use the RT-11 editor to create it as a file 
(see Chapter 5). You use tabs and spaces to format each line 
properly, and you may choose to insert comment statements 
throughout the source code to explain what various parts of the 
program are doing. When you have finished creating the pro- 
gram as a complete, edited file, you next enter it as input to the 
FORTRAN IV language processor, which is stored on your sys- 
tem volume or on a separate volume of its own. The FORTRAN 
IV language processor processes (compiles) the language state- 
ments, converting them into internal machine-language code 
called object code. This code is next processed by the system 
linker, which combines your program units and necessary sys- 
tem-supplied routines to make your program suitable for execu- 
tion. The development of an executable FORTRAN IV program 
is represented in Figure 9-1. 
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The FORTRAN IV language processor is a compiler that trans- 
lates your source program into a machine language program. 



^The PDP-11 FORTRAN IV programming language conforms to the specifi- 
cations for American National Standard FORTRAN X3.9-1966. 
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Since you create a FORTRAN IV source program in ASCII for- 
mat, you must next translate the program into a machine for- 
mat that the computer can use. The FORTRAN IV compiler 
performs the translation, producing as output a new version of 
the program, called an object module. You may instruct the 
FORTRAN IV compiler to produce a listing of the source pro- 
gram at the same time. Figure 9-2 is a diagram of the com- 
piler's function. 
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Figure 9-2 Function of a FORTRAN IV CompUer 



USING LIBRARY 
MODULES 



Typical FORTRAN IV programs often require similar opera- 
tions. Most programs, for example, use routines and instruc- 
tions that calculate square roots, exponentials, and other arith- 
metic functions; handle input and output operations; detect cer- 
tain kinds of error conditions; test values; calculate subscripts; 
and perform conversions. These commonly used operations 
have been gathered into a special file called SYSLIB.OBJ (de- 
fault System Library), which is provided with the RT-11 opera- 
ting system and is stored on your system volume. 

During the processing of your source program, the FORTRAN 
IV compiler examines each language statement in the program. 
If you use operations that are provided in SYSLIB, the compiler 
notes them and makes references to SYSLIB. The compiler 
translates all the information gathered during processing (your 
converted language statements and the references to SYSLIB) 
into numerical data called object code that the system linker 
can use. The result of the compilation, therefore, is an object 
format file, called an object module, which is automatically 
joined with SYSLIB (containing many object modules) and with 
any other required object modules at link time. Linking all the 
necessary object modules together produces a complete, work- 
able FORTRAN IV program. 

The FORTRAN IV object time system (OTS) is also needed to 
successfully compile a FORTRAN IV program; this system is in 
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the file FORLIB.OBJ. Whether this file is included in SYSLIB 
or not depends on how your system was built. 

To link the example FORTRAN IV program, you must either 
include FORLIB.OBJ in SYSLIB, or specify SYSLIB before 
FORLIB in the link command. For instructions on how to in- 
clude FORLIB in SYSLIB, refer to Section 3.4 in the RT-11 
FORTRAN IV Installation Guide. 



In Chapter 5 you used the RT-11 editor to create a FORTRAN 
IV source program, which you then stored on your storage vol- 
ume. Since a source program is in ASCII format, the next step 
is to use the FORTRAN IV compiler to convert it to object code. 

Some RT-11 systems store the FORTRAN IV compiler on a 
volume apart from the system volume.^ You can quickly deter- 
mine whether the FORTRAN IV compiler is on your system 
volume by using the DIRECTORY command. 

• DIRECTORY BY ! FDRTRA . SAV® 

In the directory listing that results, if the directory entry for 
FORTRA.SAV is included, then the required FORTRAN IV 
files are on your system volume. If, however, FORTRA.SAV did 
not appear in the directory listing, then the required files are 
not part of your system volume. Before you can use the com- 
piler, you must make a volume substitution. Read the section in 
Appendix B entitled Using the FORTRAN/BASIC Language 
Volume. 

The next step involves using the monitor COPY command to 
copy the FORTRAN IV source program from the storage vol- 
ume (where you stored it in Chapter 7) back to the system 
volume, which serves as the default volume for input/output 
operations. 

Remember that on your storage volume are two FORTRAN IV 
source programs, the one you created (GRAPH.FOR) and the 
one provided as part of the system (EXAMP.FOR). Which of 
these you should use depends on the results of the source com- 
parison you performed in Chapter 6. If the comparison resulted 
in no differences except for the title lines, copy your own pro- 
gram (GRAPH.FOR) as follows: 

Long Command Format 

.COPY® 

From? VOL ! GRAPH. FOR® 

To ? GRAPH.FOR® 



COMPILING THE 

FORTRAN IV 

PROGRAM 



This is true for any RT-11 system volume that does not have enough free 
blocks to accommodate the FORTRAN IV system files. RXOl diskette is an 
example. 
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Short Command Format 

.COPY MOL:GRAPH.FOR GRAPH. FD 



However, if differences were printed in addition to the title 
lines, use the provided program (EXAMP.FOR) instead, copy- 
ing it under the new name GRAPH.FOR: 



Long Command Format 



.COPY® 

From? yOLsEXAMP.FO 

To ? GRAPH.FOR® 



Short Command Format 



.COPY VOL:EXAMP.FOR GRAPH. FO 



FORTRAN 



The FORTRAN IV source file now resides on your system vol- 
ume under the name GRAPH.FOR and is the file that you will 
process with the FORTRAN IV compiler. The command used to 
compile a FORTRAN IV source program is the monitor FOR- 
TRAN command. 

Use the FORTRAN command with its /LIST option to compile 
your program and produce a listing. The system prompt asks 
you to supply the input file name. You can omit typing the 
.FOR file type since the FORTRAN command assumes this file 
type unless you indicate otherwise. The system will assign the 
name GRAPH.OBJ to the object module and GRAPH.LST to 
the listing file and store both newly created files on your sys- 
tem volume, which is the default storage volume for input/out- 
put operations. 



Long Command Format 

.FORTRANiH 

Files? GRAPH/LIST® 



Short Command Format 

.FORTRAN GRAPH/LIST® 



Compilation begins. If the compiler discovers an error during 

ju-x \j\^\^vDiJ±±±Q y Jl\j ^x xxxukj «^ xxx^t^kJLA^x^i J.XX «jxxxkj ^Lxx uxvc«.xf.xx v/LxO'C'j jr ^j-vx 

should see the following on your terminal printer or screen: 



.MAIN. 

?FORTRAN-I-[ .MAIN. ] Errors; 5t Warninsfs: 

FUN 

7F0RTRAN-I-CFUN ] Errors; 1» Warnings; 



This indicates that, during processing, the FORTRAN IV com- 
piler found six errors in the source program. It helps at this 
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point to look at the listing produced by the compiler, because 
more information is shown there. Print the listing on either the 
line printer or terminal, using one of the following commands: 

Long Command Format 

(Line printer) (Terminal) 

.PRINT®) .TYPEdll 

Files? GRAPH. LSTES) Files? GRAPH. LST@El 

Short Command Format 

(Line printer) (Terminal) 

.PRINT GRAPH. LST® .TYPE GRAPH . LSTEEl 

Your listing should look like the following example. 

NOTE 

You do not need to understand the FORTRAN IV lan- 
guage or the way this program works to successfully 
complete the exercises in this chapter. 

FDRTRflN lU V02,5 Sat OB-Jan-SS 15:52:04 PAGE 001 

C GRAPH. FOR VERSION 1 

C THIS PROGRAM PRODUCES A PLOT ON THE TERMINAL 

C OF AN EXTERNAL FUNCTION. FUNtX.Y) 

C THE LIMITS OF THE PLOT ARE DETERMINED BY THE DATA STATEMENTS 

C "STAB" IS FILLED WITH A TABLE OF HEIGHT FLAGS 

C "STRING" IS USED TO BUILD A LINE OF GRAPH FOR PRINTING 
0001 SCAL (ZMIN.ZMAX iMAXZ iK ) =ZMIN+FLOAT ( K- 1 ) » t ZMAX-ZMIN ) /FLOAT ( MAXZ- 1 ) 
OOOZ LOGICALU STRING ( 13 .3 ) .STAB ( 100 ) 

0003 DATA XMIN.XMAX 1MAXX/-5.5 .45/ 

0004 DATA YMIN.YMAX .MAXY/-5 .5 .72/ 

0005 DATA FMIN .FMAX/0.0 il .0/ 

COOS CALL SCOPY('- 123450789 +'.STAB) 

0007 MAXF=LEN(STAB) 

0008 DO 20 IX=1 iMAXX 

0009 X = SCAL(XMIN.XMAX iMAXX iIX) 

0010 CALL REPEAT( '»' .STRING .MAXY) 

0011 IFdX.EO.l .OR, IX.EO.MAXX) GOTO 20 

0013 DO 10 IY=2,MAXY-1 

0014 Y = SCAL(YMIN .YMAX iMAXY.IY) 

0015 IFUN=2+INT(FL0AT(MAXF-3)»(FUN(X.Y)-FMIN)/(FMAX-FMIN) ) 

0016 10 STRING(IY)=STAB(MIN0(MAXF.MAX0(1 .IFUN) ) ) 
001730 CALL PUTSTR (7 .STRING 1 ' ') 

OOIB CALL EXIT 

0019 END 

FORTRAN IV DiaSnostics for ProSram Unit .MAIN. 

In line 0003. Error: Modes of variable "XMIN" and data item differ 

In line 0004. Error: nodes of uariabie "YMIN" and data item differ 

In line 0008. Error: Reference to undefined statement label 

In line 0012. Error: Reference to undefined statement label 

In line OOlGt Error: Wrons number of subscripts for array "STRING" 



FORTRAN 


IV 


Storage Map 


for 


Program 


Unit 


.MAIN. 








Local 


Variabl 


es, .PSECT 


*DATA, Size 


= 000334 ( 110. 


wo rds ) 






Name 




Type 


Offset 




Name 


Type 


Offset 


Name 


Type 


Offset 


FMAX 




R*4 


000230 




FMIN 


R*4 


000224 


IFUN 


I*Z 


000312 


IX 




I»2 


000274 




lY 


1*2 


000300 


K 


I»2 


00025S 


MAXF 




1*2 


000280 




MAXX 


1*2 


000272 


MAXY 


1*2 


00027S 


MAXZ 




1*2 


000254 




MAXO 


I»2 


00031B 


MINO 


1*2 


000314 
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X 


R*a 


OOOZBZ 


XMflX 


R»a 


OOOZSB 


XMIN 


R«4 


000214 


Y 


R*a 


000302 


YMfiX 


R»4 


00030B 


YMIN 


R*4 


000220 


ZMflX 


R»« 


000250 


ZMIN 


R«4 


000244 









Local and COMMON Arrays: 

Nawe Type Section Offset Size Dimensions 

STAB L«l $DATft 000047 000144 ( 50.) (100) 
STRING L«l Oec $DftTA 000000 000047 ( 20.) (13.3) 

Subroutines. Functions* Statement and Processor-Defined Functions: 



Nane 


Type 


Name Type Name Type Name Type Name Type 


EXIT 


R«4 


FLOAT R«4 FUN R»4 INT 1*2 LEN I»2 


PUTSTR 


R*4 


REPEAT R«4 SCAL R»4 SCOPY R*a 


FORTRAN 


lU 


002,5 Sat 08-Jan-B3 15:52:07 PAGE 001 


0001 




FUNCTION FUN(X,Y) 


0002 




R=S0RT(X**2+Y*»Z) 


0003 




FUN = X*Y«R*EXP(-R) )_»»2 


##*#* P 






0004 




RETURN 


0005 




END 


FORTRAN 


IV 


Diaanostios for Prosram Unit FUN 


In line 


0003, 


Error: ISee source listins] 


FORTRAN 


IV 


Storase Map for Prosram Unit FUN 


Local V 


ariabl 


es, .PSECT $DATA, Size = 000020 ( 8, words) 


Name 


Type 


Offset Name Type Offset Name Type Offset 


FUN 


R»4 


000004 Equ R R»4 000010 X R»4 8 000000 


Y 


R»4 S 


000002 


Sub rout 


ines , 


Functions, Statement and Processor-Defined Functions: 


Name 


Type 


Name Type Name Type Name Type Name Type 


SORT 


R»4 





The first part of the Hsting shows the main program unit and 
consists of the language statements up to, but not including, 
the function. This is followed by a diagnostics list, then by a 
storage map. Next the language statements composing the 
function program unit are listed, again followed by a diagnos- 
tics list and a storage map. 

Before considering the individual sections of the program list- 
ing, first examine the program logic to determine what this 
program should do. The first few lines of this program are user 
comment lines that briefly describe the program. Essentially, 
this program produces on the terminal a graph of a "three- 
dimensional" function, FUN(X, Y). The graph is plotted using 
45 lines down and 72 characters across the terminal page. The 
limits of the X and Y axes are + 5 and -5. The third dimension, 
height, is a real number within the range to 1 and is repre- 
sented in the listing as a number within a scale of 1 to 9. These 
dimensions are illustrated in Figure 9-3. 

The SCAL function determines the value of the next coordinate 
on the graph. The statements within the DO loops calculate the 
coordinates using the SCAL function and determine the height 
value. This is done for an entire line of coordinates across the 
terminal page. The entire line is then printed on the terminal, 
using the CALL PUTSTR statement; the number 7 in this 
statement is the FORTRAN IV method of naming the terminal 
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Figure 9-3 Dimensions of FUN(X,Y) 

as the output device. This procedure is repeated until all 45 
lines of the graph have been printed. 

The function to be plotted is shown in the last few lines of the 
program. It is compiled as a separate program unit and you can 
edit these lines to plot any function of your choice (several al- 
ternate functions are suggested later in the chapter). 

This program as it stands contains errors. The compiler de- 
tected certain error conditions during processing that prevent 
the program from working properly. The compiler printed ap- 
propriate messages in the diagnostics sections of the program 
listing.^ Look first at the messages following the main program 
unit. Errors were discovered in lines 3, 4, 8, 12, and 16. 

The messages for lines 3 and 4 indicate that the floating-point 
variables "XMIN" and "YMIN" are assigned integer values. 
The DATA statements must be changed. (The same error exists 
for "XMAX" and "YMAX"; the compiler, however, lists only the 
first error that it discovers in a line. Both "MAXX" and 
"MAXY" are integer variable names, so no error exists for 
them.) You must correct the DATA statements (lines 3 and 4), 
then, as follows: 

DATA XMIN (XMAX »MAXX/-5.0 »5.0 .45/ 
DATA YMIN »YMAX (MAXY/-5.0 .5,0 .72/ 

The next two messages in the diagnostics section show that 
reference has been made from both lines 8 and 12 to an unde- 
fined label. (Line 12 is actually the second portion of line 11, 
the GO TO statement.) Statement label 20 is referenced in each 
case, but only labels 10 and 30 are shown in the program. This 
indicates either that a statement is missing or that a typing 



^Refer to the RT-11 System Message Manual for greater detail about any 
system messages printed. 
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error exists. Examination of the program logic shows a typing 
error in line 17. Label 30 should actually be 20. Correct line 17 
as follows: 

20 CALL PUTSTR(7 .STRING »' ') 

The last message in this diagnostics section states that an in- 
correct number of subscripts was given for the array "STRING". 
Again, examination of program logic shows that the error is 
actually in line 1. "STRING" is really a vector (a one-dimension 
array), not a matrix (a two-dimension array). Thus the comma 
is a typing error and line 2 should be changed as follows: 

LOGICAL*! STRING(133) .STABdOO) 

Skip next to the diagnostics section for the FUN program unit. 
The message printed there refers you to the source listing, to 
line 3. A letter "P" appears next to this line. The RT-11 System 
Message Manual describes a P error as an indication of unbal- 
anced parentheses. Notice that the parentheses are not prop- 
erly matched in this line. Thus, line 3 should be corrected as 
follows: 

FUI\|=(X*Y#R»EXP(-R) )**2 

This explains the errors flagged by the compiler in the diagnos- 
tics sections. Other sections of the program listing (storage 
map, for example) simply provide additional information that is 
helpful to programmers who wish to check the data types of 
various symbols and later make sure that object modules have 
been appropriately linked. 

Before you can continue the exercises in this chapter, you must 
edit, in the source program, those statements that contain er- 
rors. If necessary, review the editing commands in Chapter 5. 
Then use the RT-11 editor to edit the file GRAPH.FOR on your 
system volume so that the five lines are error-free. Do not re- 
name the file. When you are ready, recompile the program, 
using the FORTRAN command, and obtain a new object module 
and a new listing. This time the program should compile with- 
out error (that is, no diagnostics should list). The compiler will 
indicate two warnings, but you can ignore them. If diagnostics 
occur, you have not edited the program correctly. Compare list- 
ings and try to correct your errors, or go back to the beginning 
of this chapter and repeat the demonstration. 



LINKING OBJECT The object module produced by the FORTRAN command is in 

MODULES TOGETHER itself incomplete. As mentioned earlier, it needs parts of the 
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system library, SYSLIB, and perhaps other object modules and 
libraries as well, to form a complete functioning program/ All 
required object modules must be joined, or linked together, be- 
fore the program can work. 

Even if your program does not require any other object mod- 
ules, you must still link it. In addition to joining object modules 
together, the link operation adjusts the object code to account 
for many program units being placed one after the other. The 
result of the link operation is a memory image load module, 
which is actually a picture of what computer memory looks like 
just before program execution. Figure 9-4 is a diagram of the 
link operation. 



SYSLIB 
Other OBJ's 



OBJECT 
MODULE 



LINK 



— ^> 



LOAD 
MODULE 



Figure 9-4 The Link Operation 



To link the object modules, use the monitor LINK command. 
The system prompts you to enter the names of the input mod- 
ules and any libraries other than the system library to be joined 
together. You can omit typing the .OBJ file types in the com- 
mand line, since the LINK command assumes this file type for 
input. The system automatically assigns the file name of the 
first input file and a file type of .SAV to the output file. The 
linker will scan the SYSLIB library if it is present on the sys- 
tem volume. 

Some RT-11 systems store the linker (LINK.SAV) and the de- 

■r«,,u r^^-r^-i-^-^ Ku„„„„ /a-vQT TT) r\Tn\ i j. r. j.i_ _ 

XCXUJ.I/ oj-otcijii ix)ji.a.iiy \<j i.tj±ji.±j.\j±jtjj Kill ix vuiuiiie apaxL iroui me 




"^For more information on linking files and using library files, see Chapters 12 
and 13, respectively. 



9-9 



Running a FORTRAN IV Program 



system volume or the FORTRAN/BASIC language volume/ 
You can quickly determine whether the system library is on 
your system volume by using the DIRECTORY command. 

.DIRECTORY SY : SYSLIB . OB J® 

If SYSLIB.OBJ did not appear in the directory listing on your 
terminal, the required files are not part of your system volume. 
Before you can link GRAPH.OBJ, you must make a volume 
substitution. Read the section entitled Using the LINK Volume 
in Appendix B. 

If you have not included the FORTRAN IV library FOR- 
LIB.OBJ in SYSLIB, use the DIRECTORY command to see if 
the library is on your system volume. Type: 

.DIRECTORY BY ; FDRLI B . DB J® 

If FORLIB.OBJ did not appear in the directory, the required 
files are not part of your system volume. Before you can link 
GRAPH.OBJ, you must make a volume substitution. Read the 
section entitled Using the LINK Volume in Appendix B. 

Long Command Format 

FORLIB not included in SYSLIB: 

.LINK® 

Files? GRAPH tSYSLIB (FORLIB® 

FORLIB included in SYSLIB: 

.LINK® 
Files? GRAPHESI 

Short Command Format 

FORLIB not included in SYSLIB: 

.LINK GRAPH»SYSLIB>FORLIB® 

FORLIB included in SYSLIB: 

sLINK GRAPHiaSl 

Any messages printed on the terminal identify error conditions 
discovered by the system during the link operation (for exam- 



^This is true for any RT-11 system volume that does not have enough free 
blocks to accommodate the files required for linking. The RXOl diskette is an 
example. 



9-10 



Running a FORTRAN IV Program 



pie, you may not have specified all the object modules that are 
needed as input). However, assuming that you edited your 
source program correctly and that it compiled without error, it 
should also now link without error. 

A load module is one that you can run on the system. Unless 
your program contains logic errors that prevent it from running 
properly (errors that the system cannot always detect), running 
the .SAV version of your file should produce the results you 
intended. However, if logic errors exist within your program, 
running the program will produce either erroneous results or 
none at all. If this is the case, you must study the source pro- 
gram, rework it, reedit it, and perform the compile and link 
operations again. 



If your FORTRAN IV program is error-free, running the .SAV 
version should produce the expected results. In this demonstra- 
tion, running the GRAPH.SAV file should produce a graph on 
the terminal printer or screen. 

Before you run GRAPH.SAV, you have the option of changing 
the output device from the terminal printer or screen to the line 
printer by using the monitor ASSIGN command to assign de- 
vice names (see Chapter 4, Assigning Logical Names to De- 
vices). If you prefer to print the graph on the line printer, sim- 
ply assign the logical device name 7 (which is the FORTRAN 
IV code for the terminal) to the line printer code (LP:). You 
have designated a new output device without altering the 
source program. To change the device assignment to the line 
printer, type: 

Long Command Format 

.ASSIGN® 

Physical deyice name? LP:® 

LoSical deuioe name? 7®) 

Short Command Format 

.ASSIGN LPs 7® 
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This assignment remains in effect until you deassign the names 
or reboot the monitor. 

Now, to execute the FORTRAN IV demonstration program, use 
the monitor RUN command. You can omit typing the .SAV file 
type since it is assumed within the RUN command. 




Long and Short Command Format 

.RUN GRAPH® 
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After a brief pause, the graph begins to print on the terminal 
(or line printer) and should look like the graph shown in Figure 
9-5. 
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*1111 222 333333333 22 11 
)|<1111 2222 3 22 11 
*11111 22222 2222 111 
% mill 22222222222 111 

* 1111111 nil 

* 11111111 11111 

* 111111111111111111111 

* 111111111111111111 



1 
1 
11 
11 
11 
11 
1 
11 2 
11 2 
11 2 
11 2 
11 2 
1 

11 
11 



1111111111111111 
11111111111111111 
11111 11 

111 



11 ':j':5'P':>'pO'.')9'3':>9 

1 2222 22222 
22 3 22 

22 333333333 
22 333 333 

2 33 4444 333 
3 4444444 33 

33 444 4444 33 
3 444 4444 33 
33 44444444 33 
3 444 33 2 



11 

1111 

1111 

1111 

11 



333 



3333 



l"> 



1111 



■'22 1 1 
11111111 



1 
111 
111 



II * 

III * 
1111 * 
11111* 

1111* 

1111* 

111* 

111* 

111* 

111* 

111* 

1111* 

11111* 

111 * 



11 



1111 



1111 
1111 11111111 
111 222222222 111 
11 22 ':>2'-' 

1 2 333 3333 22 
11 2 3 444 33 222 
11 2 33 44444444 33 22 
11 2 3 444 4444 33 2 



11 
111 
1 



11 
111 



11 2 33 444 4444 
11 

1 

11 



33 
3 4444444 33 
33 4444 333 
333 333 



'P9'? 

'.^9':' 



11 22 333333333 22 

II 22 3 2222 

III 2222 22222 
111 02'^'^''^'^'22'^'^'^ 
1111 1 

11111 111 

111111111111111111 
11111111111111111 



11 
111 
111 
111 
1 



11111* 

1111* 

111* 

111* 

111* 

111* 

111* 

1111* 

1111* 

11111* 

1111 * 

111 * 

11 * 



********************)|<***)«******));*]);*)C****)K*)X]K]K]K)|0|(**;(;)|.;K));)K;);))t*****)C**));*]K)«*)K)H 



COMBINING 
OPERATIONS 



EXECUTE 



Figure 9^5 The Result of GRAPH.SAV 



To produce these results, you first compiled the FORTRAN IV 
source program (GRAPH.FOR), then linked it with the default 
library (SYSLIB.OBJ), and finally ran the resulting .SAV file 
(GRAPH.SAV). You can combine these three operations using 
one monitor command, the EXECUTE command. 

NOTE 

The use of the EXECUTE command requires the follow- 
ing files on your system volume: 



FORTRA.SAV 
SYSLIB.OBJ 



LINK.SAV GRAPH.FOR 
FORLIB.OBJ (if not included in SYS- 
LIB) 



If you have substituted the special LINK volume for your 
system volume, you do not have the necessary files to 
use the EXECUTE command. Proceed to the next sec- 
tion, entitled Alternate Functions. 
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The EXECUTE command instructs the system to select the lan- 
guage processor, then process, link, and run the program. There 
are several ways to establish which language processor the EX- 
ECUTE command invokes. One way is to specify a language- 
name option, such as /MACRO, which invokes the MACRO as- 
sembler. Another way is to omit the language-name option and 
specify the file type for the source files. The EXECUTE com- 
mand then invokes the language processor that corresponds to 
that file type. Specifying the file GRAPH.FOR, for example, 
invokes the FORTRAN IV compiler. A third way to establish 
the language processor is to let the system choose a file type of 
.MAC, .DBL, or .FOR for the source file you name. If, for exam- 
ple, you specify the file GRAPH, the monitor searches device 
SY: (your system device) for the files GRAPH.MAC, 
GRAPH.DBL, and GRAPH.FOR, in that order. If the monitor 
finds neither GRAPH.MAC nor GRAPH.DBL, it invokes the 
FORTRAN IV language processor to compile GRAPH.FOR. For 
example, to combine the compile-link-run operations that you 
performed in this chapter, you would use the following com- 
mand (do not actually type this command until you have read 
the next section. Alternate Functions): 

Long and Short Command Format 

FORLIB not included in SYSLIB: 

.EXECUTE GRAPH/FORTRAN/LIST/LINKLIBsSYSLIB/LINKLIB: FORLIB® 

FORLIB included in SYSLIB: 

.EXECUTE GRAPH/FORTRAN/LIST® 



The following are some alternate functions that you can substi- ALTERNATE 

tute in your FORTRAN IV source program to produce different FUNCTIONS 

graphs. Simply reedit the program (GRAPH.FOR) so that lines 
1-5 in the function portion at the end contain one of the follow- 
ing alternate functions. Then compile, link, and run the pro- 
grams as described in the previous sections. If the necessary 
files are available on your system volume (see the previous sec- 
tion. Combining Operations), use the EXECUTE command to 
run the program. The source program compiles, links, and runs, 
and the new graph prints on the terminal (or line printer). 

Function 1 

FUNCTION FUN(X>Y) 
FUN=EXP(-S0RT(X**2+Y#*2) ) 
RETURN 
END 

Function 2 

FUNCTION FUN(X»Y) 

R=S0RT(X*#Z+Y**2) 

FUN = X*Y*(R-3. )/(l .+EXP(3.*(R-3.5) ) ) 

RETURN 

END 
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Function 3 

FUNCTION FUN(XtY) 

FUN = EXP(+S0RT(X**Z + Y**2) ) /1 177.4 

RETURN 

END 



SUMMARY: 
COMMANDS TO 
RUN FORTRAN 
PROGRAMS 



EXECUTE 

Combine the compile-link-run operations into one command. 

EXECUTE file 

Combine the compile-link-run operations into one command. 
Specify the libraries to be used during linking. 

EXECUTE file/FORTRAN 

Combine the compile-link-run operations into one command, 
and specify the input file to be a FORTRAN file. 

EXECUTE/LIST 

Combine the compile-link-run operations into one command. 
Obtain a listing file of the source program and print on line 
printer. 

FORTRAN 

Compile the FORTRAN IV source program and produce an 
object module. 

FORTRAN/LIST 

Compile the FORTRAN IV source program and produce both 
an object module and a listing file. 

LINK 

Link individual object modules together to form a complete 
program and produce a load module. 

RUN 

Run the indicated load module. 



FILE MAINTENANCE 



Before continuing further you should perform the necessary file 
maintenance operations. 

NOTE 

If you used a special LINK volume to perform this dem- 

nnotrotinn ti irn nn\A/ tn tho cootinn ontitlci/H POQ_ 

IRAN/LINK File Maintenance in Appendix B. 

Obtain a directory of all files on your system volume that have 
the name GRAPH regardless of file type; these files were cre- 
ated as a result of the exercises in this chapter. 
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Long and Short Command Format 

"\ .DIRECTORY GRAPH.*® 
' OB-Jan-83 

GRAPH .SAV 21 08-Jan-83 GRAPH .LST 8 08-Jan-83 
GRAPH .BAK 2 08-Jan-83 GRAPH .FOR 2 08-Jan-83 
GRAPH .OBJ IB 08-Jan-83 
5 Files , 49 Blocks 
447 Free blocks 

The fact that you have corrected errors in the source file 
GRAPH.FOR makes the version of that file on your storage 
volume obsolete. Therefore, transfer the updated copy from 
your system volume to VOL:, replacing the copy of 
GRAPH.FOR on the storage volume with the new version. 

Long Command Format 

\ .COPYEH 

/ From? GRAPH.FOR© 

To ? MOLsGRAPH.FOR® 

Short Command Format 

.COPY GRAPH.FOR UOL ! GRAPH , FOR® 

Similarly, transfer GRAPH.LST, GRAPH. OBJ, and 
GRAPH.SAV to your storage volume. This allows you to exam- 
j ine a listing or rerun the FORTRAN IV program without re- 

compiling and relinking the source. 

Long Command Format 

.COPY® 

From? GRAPH.LST (GRAPH . OB J (GRAPH . SAM® 
To ? VOL:® 
Files copied: 

j DK; GRAPH. LST to UOL : GRAPH . LST 

DK:GRAPH.OBJ to MOL : GRAPH . OB J 

DK:GRAPH.SAy to MOL : GRAPH ; SAM 

Short Command Format 

.COPY GRAPH.LST (GRAPH. OBJ (GRAPH. SAM MOL:® 
Files copied: 
DKiGRAPH.LST to MOL : GRAPH . LST 
DK:GRAPH.OBJ to MOL : GRAPH . OB J 
DK:GRAPH.SAM to MOL : GRAPH . SAM 

Once you have transferred all files of value to your storage 
volume, delete the useless files — that is, all the GRAPH 
files — from the system volume. 
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Long Command Format 

.DELETE® 
Files? GRAPH.*®) 

Files deleted; 
DK:GRAPH.BAK ? Y® 
DK: GRAPH. SAU ? Y® 
DK:GRAPH.FOR ? Y® 
DK:GRAPH.LST ? Y® 
DK; GRAPH. OB J ? Y® 

Short Command Format 

.DELETE GRAPH.*® 
Files deleted; 
DK: GRAPH. BAK ? Y® 
DK: GRAPH. SAy ? Y® 
DK:GRAPH.FOR ? Y® 
DK:GRAPH,LST ? Y® 
DK:GRAPH,OBJ ? Y® 

Finally, obtain an up-to-date directory listing of your storage 
volume so that you can see its current status. 

Long and Short Command Format 



.DIRECTORY 


UOL: 


® 










08-Jan-83 














SUM .MAC 


3 


08-Jan-83 


EXAMP 


.FOR 


2 


2B-AL13-82 


EXAMP .MAC 


3 


ZB-AU3-82 


GRAPH 


.FOR 


2 


08-Jan-B3 


GRAPH .LST 


8 


OB-Jan-83 


GRAPH 


.OBJ 


IB 


08-Jan-83 


GRAPH .SAM 


21 


08-Jan-83 










7 Files , 55 bl 


ooKs 










4707 Free 


bloc 


Ks 











This completes the FORTRAN IV demonstration. Continue to 
Chapter 12 to read about the linking process. If you followed 
the special instructions in Appendix B to load the language 
volume, leave this volume in device unit until you have fin- 
ished Chapter 12. 



REFERENCES McCracken, Daniel D., A Simplified Guide to FORTRAN Programming. New 

York: Wiley, 1974. 

An introduction to programming in the FORTRAN language. 

PDP-11 FORTRAN Language Reference Manual (AA-1855D-TC). Maynard, 
Mass.: Digital Equipment Corporation, 1980. 

A reference manual and guide to programming in the PDP-11 FOR- 
TRAN rV language. 

RT-11 FORTRAN IV Installation Guide (AA-5240E-TC). Maynard, Mass.: 
Digital Equipment Corporation, 1980. 

An RT-11 -specific manual that contains instructions for installing the 
RT-11 FORTRAN IV language processor, and describes known prob- 
lems and differences between versions. 

RT-11 RSTS-E FORTRAN TV User's Guide (AA-5749B-TC). Maynard, 
Mass.: Digital Equipment Corporation, 1980. 

An RT-11-specific manual that contains information necessary to com- 
pile, link, run, and debug a FORTRAN IV program. 
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CHAPTER 10 
RUNNING A BASIC-11 PROGRAM 



The BASIC-11 program language '^ is a machine-independent 
programming language that is one of the easiest languages for 
the beginning programmer to learn. It has both elementary lan- 
guage features that you use to write simple programs, and more 
advanced operations that allow you to produce complex and effi- 
cient programs. In addition, a special "immediate mode" lets 
you use BASIC-11 like a calculator to obtain instant answers 
to mathematical problems. 



BASIC (Beginner's All-purpose Symbolic Instruction Code) -11 
is conversational in nature. It uses simple English keywords 
and common mathematical expressions to form easily under- 
stood language statements. 

You write a BASIC-11 program as a series of one or more pro- 
gram lines. You begin each program line with a number that 
both identifies the line and indicates the order in which the line 
will be processed. Individual program lines contain one or more 
BASIC-11 language statements that define the operations to be 
performed. 

When you are satisfied with the logic of your BASIC-11 source 
program, you create it as a file. However, unlike your methods 
under other programming languages, you create the file under 
the control of the BASIC-11 language processor, which is part 
of the RT-11 operating system and is stored on your system 
volume or on a separate volume of its own. Thus, you use com- 
mands that are part of the BASIC-11 language processor to 
create and edit the program, list it, run it, and save it for later 
use. 



DEVELOPING 

A BASIC-1 1 

PROGRAM 



The BASIC-11 language processor is an interactive interpreter. 
It allows you to create and execute a program in its entirety or 
a few lines at a time. The interpreter examines each program 
lansruafire statement, internrfits it. nnd ftvprntfis if hofnro o-nincr 
on to the next. If it discovers an error that prevents further 
processing, it prints on the terminal a message informing you of 
the error condition and stops. You correct the error so that exe- 
cution can continue past that point, and then rerun the pro- 
gram. 



^BASIC-11 is a superset of the standard BASIC language developed at Dart- 
mouth College. 



USING THE 

BASlC-1 1 

LANGUAGE 

DOnOCQCAD 

■ a M >%^ ^^ t^ ^ <%^ '^ B B 
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BASIC 



CREATE 




EDIT 




RUN 





Figure 10-1 Functions of the BASIC- 
Language Processor 



11 



USING THE 
BASIC-1 1 
INTERPRETER 



The functions of program creation, editing, processing, and exe- 
cution are all handled by the BASIC-11 language processor. 
Some RT-11 systems store the BASIC-11 interpreter (language 
processor) on a volume apart from the system volume/ You can 
quickly determine whether the BASIC-11 interpreter is on 
your system volume by t5^ing the monitor DIRECTORY com- 
mand and specifying the BASIC.SAV program. 



♦ DIRECTORY BASIC. SAU® 




In the directory listing that results, if the directory entry for 
BASIC.SAV is listed on your terminal, then the required 
BASIC-11 files are on your system volume and you are ready to 
use the interpreter. However, if BASIC.SAV did not appear in 
your listing, then the required files are not part of your system 
volume. Before you can use the interpreter, you must make a 
volume substitution. Read the section in Appendix B entitled 
Using the FORTRAN/BASIC Language Volume. 

Now use the monitor BASIC command to activate the 
BASIC-11 interpreter: 

Long and Short Command Format 



.BASIC®) 

BASIC-ll/RT-11 U2.1 
OPTIONAL FUNCTIONS (ALL 



NONE* OR INDIVIDUAL)' 



A 



JJXUlllpLllJ.g IXlCiBOClg'C 






T3 A orn 1 1 

XJJHLkJXV-' — J. X . 



XUU. XIXUOL XC- 



spond with an A, N, or I and a carriage return to indicate 
whether you want to preserve all, none, or some of the arithme- 
tic functions initially provided by BASIC-11. BASIC-1 1's func- 
tions include operations that calculate random numbers, deter- 



^This is true for any RT-11 system volume that does not have enough free 
blocks to accommodate the BASIC-11 system files. RXOl diskette is an 
example. 
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mine absolute values, convert octal and binary numbers to deci- 
mal, and so on. You can conserve memory space by saving only 
those functions that your program needs. For now, however, 
instruct BASIC-11 to save all the functions. 



A® 
READY 

BASIC-11 prints the READY message to indicate that it is 
ready to accept a BASIC-11 command. Any text that you type 
that is not preceded by a BASIC-11 command is accepted as 
program (or immediate mode) input. If at any time you wish to 
return to the monitor command mode, simply type the BYE 
command following the READY message. READY appears 
after any BASIC-11 execution that is completed or interrupted 
by a double CTRL/C, or after any BASIC-11 wait condition that 
is terminated by a single CTRL/C. 

NOTE 

You do not need to understand the BASIC-1 1 language 
or the way the examples work to perform successfully 
the exercises in this chapter. 




Immediate mode allows you to use the BASIC-11 interpreter 
like a calculator to obtain immediate answers to arithmetic 
problems. You enter the appropriate BASIC-11 statement key- 
word and any necessary mathematical formula. When you 
press the carriage return key, BASIC-11 immediately calcu- 
lates and prints the results. (Use the terminal DELETE key 
and the CTRL/U command to correct any typing errors.) 



Immediate Mode 



PRINT (128 + 75)#3® 
B09 



BASIC-11 adds the two numbers in parentheses, m-ultiplies 
them by 3, and prints the answer. The PRINT statement causes 
the answer to be printed on the terminal. The following com- 
mand provides another example: 




PRINT INT(3a.B7)( 
34 

READY 



The greatest integer less than or equal to 34.67 is printed. 

You can combine several statements on a single line, or on 
several lines, including variable names, arithmetic equations, 
and data. Individual statements are separated from one an- 
other by a backslash (\) character. BASIC-11 considers all the 
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information, calculates the answer and prints it on the ter- 
minal, as illustrated in the following example: 

A = 5\B=14\C=.3729@Sl 

READY 

PRINT "THE HEIGHT I S " i A*SIN ( C ) +B i " METERS"® 

THE HEIGHT IS 15,8216 METERS 

READY 

The first statement equates variable names with values; the 
second statement introduces a formula for calculating a result 
and prints it. 

You can use immediate mode to solve fairly lengthy and com- 
plicated mathematical problems by combining statements and 
printing identifying messages. However, immediate mode infor- 
mation is temporary. You cannot save it, and you can change it 
only by retyping every statement line. If your needs are more 
complex, or if you want to save your statements, you should 
create a BASIC-11 program. 



Creating and Editing 
a BASIC-11 Program 




To create a BASIC-11 program, assign line numbers to lan- 
guage statements and then type the numbered statements on 
the terminal keyboard. 

Now your program lines are saved in memory and you can 
transfer program control to specific lines within the program, 
repeat parts of the program any number of times, store the 
entire program for later use, and perform other similar opera- 
tions that are not possible in immediate mode. 

Once you have created the program, you use BASIC-11 editing 
commands to list lines, change lines, add and erase lines, and 
correct typing errors. In addition to the DELETE key and the 
CTRL/U command, BASIC-11 provides a SUB comm.and (SUB- 
STITUTE) for correcting typing errors. This command allows 
you to substitute new characters for existing ones in a line. For 
example, type: 



10 PRINT "THIS IS A BADIC PROGRAM" 

SUB 10 @BAD@BAS@(rSI 

10 PRINT "THIS IS A BASIC PROGRAM' 

READY 



The SUB command substitutes the letters BAS for BAD in line 
10. Use a delimiting character (shown here as @) to separate 
the old text from the new. The delimiter can be any character 
as long as it is unique in the line. The corrected line is automat- 
ically printed by BASIC-11 after you use the command. As 
another example, type: 



10-4 



Running a BASIC-11 Program 



15 B=10\C = 5(rSI 

20 LET A-B+C\PRINT C® 

There are two typing errors in line 20; the - should be an = 
and the C at the end of the line should be A. These errors can be 
corrected with the SUB command, as follows: 



SUB 20 @-e = @® 

20 LET A=B+C \ PRINT C 

READY 

SUB 20 @C@Ae2E) 

20 LET A=B+C \ PRINT A 

READY 



The second SUB command changes the second occurrence (spec- 
ified by the 2 after the last @) of C to A. 

You can erase an entire line by typing the line number followed 
by a carriage return: 



You can also use BASIC-11's DEL command\ Use the DEL 
command (DELETE) to erase a single line or several: 



DEL 15-20(i 




This erases all statements with line numbers between and in- 
cluding 15 and 20. 

To list lines of a program, BASIC-11 provides the LIST com- 
mand. First, create a few program lines: 

5 FOR 1 = 1 TO lOm 
20 INPUT J® 
25 LET T = T+J® 
50 NEXT I® 

55 PRINT "THE TOTAL IS" ST® 
88 END® 

List individual lines by specifying the line number. For ex- 
ample, type: 

LIST 5® 

NONAME 08-JAN-83 00:10:43 

5 FOR 1=1 TO 10 

READY 



LIST 



^Do not confuse the BASIC-11 DEL command with the DELETE key on the 
terminal keyboard. 
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LISTNH 



Notice that BASIC-11 prints a header line. Since you have not 
as yet assigned a name to your program, BASIC-11 assigns it 
the name NONAME and prints this name, along with the date 
(which is only correct if previously entered via the DATE mon- 
itor command) and the time when you use the LIST command. 
You can omit the header line by using the LISTNH command 
instead of the LIST command. 




LISTNH 50-8 



50 NEXT I 

55 PRINT "THE TOTAL IS" iT 

88 END 

READY 



By typing the LIST or LISTNH commands without indicating 
any line numbers, you can print on the terminal a listing of 
your entire program. Terminate the command with a carriage 
return. 



LISTNH® 

5 FDR 1=1 TO 10 

20 INPUT J 

25 LET T=T+J 

50 NEXT I 

55 PRINT "THE TOTAL IS" iT 

as END 

READY 



Finally, to erase the entire program, which you must do before 
typing a new program, use the SCR (SCRATCH) command. 



SCR® 
READY 



All program lines are erased from memory. 



SUMMARY: 
BASIC-11 EDITING 
COMMANDS 



line# 

Erase the indicated program lines. 

DEL line # 

Erase the indicated program lines. 

LIST 

List the entire program and print a header that includes the 
program name, date, and time. 

LIST line # 

List the indicated lines and print a header that includes the 
program name, date, and time. 
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LISTNH 

List the entire program but do not print a header. 

LISTNH line # 

List the indicated lines but do not print a header. 

SCR 

Erase all program lines from memory and change the name 
to NONAME. 

SUB line #@FIRST@SECOND@n 
Replace the nth occurrence of the FIRST character(s) with 
the SECOND character(s) in the indicated line (default is 
n=l). 

Create the following demonstration programS using the appro- 
priate BASIC-11 editing commands, exactly as it appears here. 
If you forget to insert a line, type it at the end or when you 
notice the omission; BASIC-11 sorts and arranges lines by 
number before execution, regardless of the order in which they 
are typed. When you have finished, list the entire program and 
make a final check for typing errors. 

100 REM THE PROGRAM 23 MATCHES 

101 REM 

110 PRINT "WE BEGIN WITH 23 MATCHES. YOU MDUE FIRST. YOU" 

115 PRINT "MAY TAKE 1 . 2 , OR 3 MATCHES. TYPE YOUR CHOICE" 

120 PRINT "FOLLOWED BY A CARRIAGE RETURN. THEN THE COM-" 

125 PRINT "PUTER CHOOSES 1 . 2 , OR 3 MATCHES. YOU CHOOSE" 

130 PRINT "AGAIN, AND SO ON. WHDEUER MUST TAKE THE LAST" 

135 PRINT "MATCH, LOSES." 

140 PRINT \ LET M=23 

200 REM THE HUMAN MOUES " 

201 REM 

210 PRINT \ PRINT "THERE ARE NOW" iM ! "MATCHES . " 

215 PRINT \ PRINT "HOW MANY DO YOU TAKE"! 

230 INPUT H 

240 IF H>M THEN 510 

250 IF H<>INT(H THEN 510 

2B0 IF H<=0 THEN 510 

270 IF H>=4 THEN 510 

280 LET M=M-H 

290 IF M=0 THEN 410 

300 REM THE COMPUTER MDUES 

301 REM 

305 IF M=l THEN 440 

310 LET R=M-4«INT(M/4) 

320 IF ROl THEN 350 

330 LET C=INT(3#RND)+1 \ GO TO 3B0 

350 LET C=(R+3)-4*INT( (R+3)/4) 

3G0 LET M=M-C 

370 IF M=0 THEN 440 

380 PRINT \ PRINT "THE COMPUTER TOOK " i C 5 "...." ! 

380 GO TO 310 

400 REM SOMEBODY WON 

401 REM 

410 PRINT \ PRINT "THE COMPUTER WON." \ GO TO 899 
440 PRINT \ PRINT "YOU WON." \ GO TO 399 

500 REM BAD INPUT 

501 REM 

510 PRINT "ENTER ONLY 1, 2, OR 3." \ GO TO 215 
398 END 



•^23 Matches, 101 BASIC Computer Gaines, Maynard, Mass.: Digital Equip- 
ment Corporation, 1975. 
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As you can see from the first few lines of the listing, this pro- 
gram is a mathematical game where you match your logic 
against the program logic. The PRINT statements in the pro- 
gram print messages, game instructions, results, and so forth, 
on the terminal. The REM statements identify comment 
lines — remarks that provide general information about the 
program, but that are ignored by BASIC-11 during processing. 
The INPUT statement in line 230 allows you to supply data 
from the terminal. Depending on the value you enter, program 
control transfers to various other parts of the program. For ex- 
ample, if you type an invalid value, program control skips 
ahead to a PRINT statement in line 510 informing you of your 
mistake and then returns to line 215 to ask for a value again. 
The mathematical algorithms of this program are in lines 310 
through 350, which determine the number of matches the com- 
puter will select based on your choice. 



RUNNING A 
BASIC-11 PROGRAM 




Once you have typed the program and checked the listing to be 
sure that it corresponds to the example, you are ready to run it. 
The BASIC-11 RUN command initiates program execution. 
This command prints a header that includes the program name, 
date, and time. If you want to omit the header line, type the 
RUNNH command instead. 

RUNNH® 



If you typed the program correctly, you will see this text print 
on your terminal: 



WE BEGIN WITH 23 MATCHES. YOU MOUE FIRST. YOU 
MAY TAKE 1» 2» OR 3 MATCHES. TYPE YOUR CHOICE 
FOLLOWED BY A CARRIAGE RETURN. THEN THE COM- 
PUTER CHOOSES 1» 2, OR 3 MATCHES. YOU CHOOSE 
AGAIN » AND SO ON. WHOEVER MUST TAKE THE LAST 
MATCHt LOSES. 



THERE ARE NOW 23 MATCHES. 
HOW MANY DO YOU TAKE? 

NOTE 

If this response does not appear, you have not entered 
the program correctly. Compare your listing very care- 
fully against the one provided earlier. Spacing does not 
matter, but all other characters must match. To correct 
your errors type CTRL/C, which, under control of 
BASIC-11 only, returns you to BASIC-11 command 
mode, indicated by the READY message. Correct the 
program and then rerun it. 
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When the program pauses and asks you a question, you must 
supply data, in this case a 1, 2, or 3. Type your choice (repre- 
sented here by n), followed by a carriage return: 



7SYNTAX ERROR AT LINE 250 
READY 



BASIC-11 discovered an error ^ in line 250 that prevents fur- 
ther processing. Check line 250 in your listing or list it on the 
terminal: 



LISTNH Z50m 

250 IF HOINKH THEN 510 

READY 



Note that a right parenthesis is missing after the second H in 
this line. Correct the line using the SUBSTITUTE command: 



SUB 250 @(H@(H)I 

250 IF H<>INT(H) THEN 510 

READY 



You are ready to run the program again. 

RUNNH® 

BASIC-11 begins processing at the start of the program. 

WE BEGIN WITH 23 MATCHES. YOU HOME FIRST, YOU 
MAY TAKE 1 t 2 » OR 3 MATCHES. TYPE YOUR CHOICE 
FOLLOWED BY A CARRIAGE RETURN. THEN THE COM- 
PUTER CHOOSES 1, 2, OR 3 MATCHES. YOU CHOOSE 
AGAIN* AND SO ON. WHOEMER MUST TAKE THE LAST 
MATCH, LOSES. 

THERE ARE NOW 23 MATCHES. 

HOW MANY DO YOU TAKE? 

Type your choice again. But notice this time that a different 
kind of error is detected. The BASIC-11 interpreter has entered 
an infinite loop, a series of commands that it repeats endlessly. 
After several lines have printed, type a double CTRL/C; this 
interrupts execution and returns control to BASIC-11 com- 
mand mode. 



CTRL/C CTRL/C 



^Refer to the RT-11 System Message Manual for greater detail about any 
messages printed during normal system use. 
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THE 


COMPUTER 


TOOK 


1 


THE 


COMPUTER 


TOOK 


1 


THE 


COMPUTER 


TOOK 


3 


THE 


COMPUTER 


TOOK 


2 


THE 


COMPUTER 


TOOK 


2 


THE 


COMPUTER 


TOOK 


3 


THE 


COMPUTER 


TOOK 


1 


THE 


COMPUTER 


TOOK 


1 


THE 


COMPUTER 


TOOK 


3 


THE 


COMPUTER 


TOOK 


1 


THE 


COMPUTER 


TOOK 


3 


(CTRL/ C) (CTRL/ C) 






STOP AT LINE 


380 





READY 

An infinite loop is a programming logic error. However, since 
the error does not prevent processing, BASIC-11 does not print 
an error message. Instead BASIC-11 is caught in a loop of in- 
structions and executes them endlessly. This particular loop is 
obvious because it prints a line of text; other kinds of loops may 
not be so evident. At this point you must examine the program 
logic to determine why these instructions are being repeated. 

Look at your listing of this program. The problem in this case is 
in line 390. This line instructs program control to return to line 
310; therefore lines 310 through 390 are repeated endlessly 
without ever obtaining your next value choice. Program control 
should really return to line 210. Correct line 390 as follows: 

SUB 390 e310@210ia(RB) 
390 GO TO 210 

READY 

Now you are ready to run the program again. This time the 
entire program should execute without error. Enter your value 
choices when requested. (A hint to playing the game: your first 
value choice determines whether you can win; if your first 
choice is wrong, the program has the advantage throughout.) A 
sample run follows. 

RUIMNHED 

WE BEGIN WITH 23 MATCHES. YOU MOVE FIRST. YOU 
MAY TAKE 1 » Z » OR 3 MATCHES. TYPE YOUR CHOICE 
FOLLOWED BY A CARRIAGE RETURN. THEN THE COM- 
PUTER CHOOSES 1» 2» OR 3 MATCHES. YOU CHOOSE 
AGAIN » AND SO ON. WHOEMER MUST TAKE THE LAST 
MATCH* LOSES. 

THERE ARE NOW 23 MATCHES. 
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HOW MANY DO YOU TAKE? IE) 

THE COMPUTER TOOK 1 .... 
THERE ARE NOW 21 MATCHES. 

HOW MANY DO' YOU TAKE? lO 

THE COMPUTER TOOK 3 . . . . 
THERE ARE NOW 17 MATCHES. 

HOW MANY DO YOU TAKE? Z®) 

THE COMPUTER TOOK 2 .... 
THERE ARE NOW 13 MATCHES. 

HOW MANY DO YOU TAKE? KbH 

THE COMPUTER TOOK 3 . . , , 
THERE ARE NOW 9 MATCHES. 

HOW MANY DO YOU TAKE? 1® 

THE COMPUTER TOOK 3 . . . . 
THERE ARE NOW 5 MATCHES. 

HOW MANY DO YOU TAKE? 2m 

THE COMPUTER TOOK 1 .... 
THERE ARE NOW 1 MATCHES. 

HOW MANY DO YOU TAKE? 0® 
ENTER ONLY 1 » 2 » OR 3. 

HOW MANY DO YOU TAKE? im 

THE COMPUTER WON. 

READY 



RUN 

Execute the BASIC-11 program currently in memory; print a 
header Hne including the program name, date, and version 
number. 

RUNNH 

Execute the BASIC-11 program currently in memory; omit 
the header line. 

CTRL/C 

Under control of BASIC-11 only, interrupt execution of the 

T3 A OT/^ 11 ] J J. 1 J.- -n A OT/^ i i 

ucuDLKj—i-x pxugiaiii aiiu return uoui/iui LU JDAOIO— 11 com- 
mand mode. 



SUMMARY: 

BASIC-11 

EXECUTION 

COMMANDS 



BYE 



Return control to monitor command mode (only when using 
BASIC-11). 
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FILE MAINTENANCE 




You can transfer the BASIC-11 program currently in memory 
to a storage volume by using the SAVE command of BASIC. 
The SAVE command copies the program to the storage volume 
and gives the program the file name and file type that you 
indicate in the command line. A file type of .BAS is assigned 
automatically unless you indicate otherwise. 

Use the SAVE command to store this BASIC-11 program as 
MATCH.BAS on the storage volume (VOL:) as follows: 

SAUE VOL:MATCH{RH) 




READY 



After you save a BASIC-11 program on a storage volume, you 
can create a new program in memory by typing the BASIC-11 
NEW command. This command erases the current memory con- 
tents and asks you for a new program name: 



NEW® 

NEW FILE NAME- 




You can type any file name you wish and BASIC-11 assigns it 
to the file you create. Or you can respond by tjrping only a 
carriage return; BASIC-11 then assigns the file name NO- 
NAME. 

Another way to create a new program in memory is to type the 
BASIC-11 SCR command. This command simply erases the 
current memory contents. It assigns the name NONAME: 

SCR® 
READY 

To use an existing BASIC-11 program, one that you have pre- 
viously stored on a storage volume, type the BASIC-11 OLD 
command: 

OLD® 

OLD FILE NAME-- 

Reply by typing the device name, file name, and file type of the 
file that you want to use. If you omit an explicit device name, 
BASIC-11 assumes DK: (the default volume); if you omit an 
explicit file type, BASIC-11 assumes .BAS. BASIC-11 erases 
memory and then copies the program from the volume into 

momnrv T?nr OYnmnlo <-Amo- 

UOLsMATC 



READY 



This copies VOL:MATCH.BAS back into memory. 

Assume that you have edited or changed the MATCH.BAS file 
and now want to transfer it back to VOL:. Since the file already 
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exists as MATCH.BAS on that volume, you must use the 
BASIC-11 REPLACE command: 

REPLACE VOLsMATCH® 
READY 

The REPLACE command replaces an existing file with a new 
version. 

The SAVE and REPLACE commands copy a BASIC-11 pro- 
gram from computer memory to a storage volume. As these 
commands copy the program, they convert it fi"om the internal 
format used by BASIC-11 to ASCII format. Thus, you can, if 
you prefer, use the RT-11 editor to create and edit BASIC-11 
programs, since the editor also uses ASCII format. However, 
many users would rather use BASIC-11 to create and edit a 
BASIC-11 program, since they can then run the program, 
reedit it, rerun it, and save the new version — all in BA- 
SIC-11 command mode — rather than perform the several cor- 
responding monitor commands. 

The last file maintenance operation that you should perform is 
to obtain an up-to-date directory of your storage volume so that 
you can see its current status; however, you must return to 
monitor command mode to do this. Type the BYE command; 
this BASIC-11 command (rather than CTRL/C) returns control 
to monitor command mode. Next use the DIRECTORY monitor 
command to check the status of your storage volume. 

BYE® 



REPLACE 



.DIRECTORY/BRIEF VOL: 

0B-Jan-B3 
SUM .MAC EXAMP .FDR 
GRAPH .OBJ GRAPH .SAW 

8 Files ( 58 BlooKs 

4704 Free blocks 



EXAMP .MAC GRAPH .FOR GRAPH .LST 
MATCH .BAS 



NEW 

Create a new BASIC-11 program, assigning the file name 
indicated. 

OLD 

Copy into memory an existing BASIC-11 program (for use 
under BASIC-11). 

REPLACE 

Copy the BASIC-11 program currently in memory to the in- 
dicated storage volume, replacing the version that already 
exists on that volume. 

SAVE 

Copy the BASIC-11 program currently in memory to the in- 
dicated storage volume. 



SUMMARY: 

BASIC-11 FILE 

MAINTENANCE 

COMMANDS 
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This completes the BASIC-11 demonstration. Before you con- 
tinue to Chapter 14 to learn about program debugging, make 
sure that the main system volume is loaded in device unit 0. If 
you followed the special instructions in Appendix B to load the 
language volume, you should now stop the system, unload that 
volume, load the main system volume, and rebootstrap the 
system. 



REFERENCES BASIC-ll Language Reference Manual (AA-1908A-TC). Maynard, Mass.: 

Digital Equipment Corporation, 1976. 

A reference manual and guide to programming in the BASIC-11 lan- 
guage. 

BASIC-11 /RT-11 Installation Guide and Release Notes (AA-K724B-TC). 
Maynard, Mass.: Digital Equipment Corporation, 1983. 

An RT-11-specific manual that contains instructions for installing the 
RT-11 BASIC-11 language processor and lists known problems and 
differences between versions. 

BASIC-ll/RT-11 User's Guide (AA-5071B-TC). Maynard, Mass.: Digital 
Equipment Corporation, 1983. 

An RT-11-specific manual that contains information necessary to 
create, edit, run, and debug a BASIC-11 program. 
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CHAPTER 11 
RUNNING A MACRO-11 ASSEMBLY LANGUAGE PROGRAM 



The MACRO-11 programming language is a machine-depend- 
ent programming language developed for the PDP-11 program- 
mer, or for the FORTRAN IV programmer who intends to com- 
bine assembly language routines and FORTRAN IV routines. 
The MACRO-11 language enables the knowledgeable program- 
mer to access all the features of the RT-ll computer system 
using a precise and efficient programming code. 



The MACRO-11 assembly language uses the PDP-11 instruc- 
tion set, a list of mnemonic instructions that correspond to vari- 
ous PDP-11 computer operations. These instructions allow you 
to add, compare, increment, complement, and perform many 
other manipulations on numerical data. The instructions are 
summarized in a pocket-sized folding card, called the PDP-11 
Programming Card (Figure 11-1), and are described in detail 
in the PDP—11 Processor Handbook. By choosing the appropri- 
ate instructions and by providing any additional data needed, 
you can create a complete program. 



DEVELOPING 

A MACRO-11 

ASSEMBLY 

LANGUAGE 

PROGRAM 







Ct^ Oft<*W 



Figure 11-1 PDP-11 Programming Card 

You write the MACRO-11 program as a sequence of lines, each 
a single assembly language statement in the following format: 

LABEL: OPERATOR OPERAND(S) COMMENTS 

... ji.jL'^ ^J'Px^JL «^U\^JL t^^M.^M \JJ. 'Cr^K^A «^XAV«. LAXV/ XX XIJ* UX lUL^ UX VXJLO OOXOV U'C'U. XX VIXJ. LXXC 

PDP-11 instruction set, data needed by the instructions, or as- 
sembler directives (instructions to the assembler to guide the 
assembly process). The optional statement label identifies the 
statement line so that you can refer to the instructions or data 
on that line from other parts of the program. Optional com- 
ments describe generally what operations are being done. 
Sequences of language statements constitute a routine (to per- 
form a specific function); groups of routines and data compose 
the entire executable program. 
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When you are satisfied with the logic of your MACRO-11 
source program, you use the RT-11 editor to create it as a file 
(see Chapter 5). You use tabs and spaces to make the program 
more readable. When you have finished creating the program 
as a complete, edited file, you next enter it as input to the 
MACRO-11 language processor, which is part of the RT-11 
operating system and is stored on your system volume. The 
MACRO-11 language processor processes (assembles) the lan- 
guage statements, converting them into an internal machine 
language code called object code. This code is next processed by 
the system linker, which combines your program units and 
makes the program suitable for execution. Figure 11-2 repre- 
sents the development of an executable MACRO-11 program. 



CREATE 




EDIT 




ASSEMBLE 




LINK 




RUN 











Figure 11-2 Evolution of a MACRO-11 Program 



USING THE 
MACRO-11 
LANGUAGE 
PROCESSOR 



The MACRO-11 language processor is an assembler that ac- 
cepts information in one format (that is, your source program) 
and translates it into another format (that is, a machine lan- 
guage program). The assembler interprets and processes the 
assembly language statements, one at a time, and generates 
one or more computer instructions or data items. Since you 
originally use the editor to create a MACRO-11 program in 
ASCII format, you must next translate it into a machine format 
that the computer can use. The MACRO-11 assembler per- 
forms this conversion, producing as output a new version of the 
program, in object format, called an object module. You may 
request the MACRO assembler to produce a listing of the 
source program at the same time. The role of the assembler is 
represented below in Figure 11-3. 



SOURCE 
PROGRAM 



ASSEMBLE 



OBJECT 
MODULE 



LISTING 
(OPTIONAL) 



Figure 11-3 Function of a MACRO-11 Assembler 
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During assembly processing, the MACRO-11 assembler: 

9 Accounts for all instructions used within the source program 
and determines their relative positions in computer memory; 
it does this by means of a storage location (program) counter. 

9 Keeps track of all user-defined symbols and their respective 
values in a symbol table. 

® Converts assembly language mnemonics, user-defined sym- 
bols, and data values into their respective machine language 
(object code) equivalents. 



The program counter keeps track of addresses in computer 
memory where instructions and data will be stored. 

PDP-11 computer memories are composed of physical storage 
locations that can hold numerical data. These locations are 
numbered consecutively from up to the highest memory loca- 
tion, which varies according to the amount of memory acquired 
with the computer system (Figure 11-4). PDP-11 computers 
used in an RT-11 system have at least 32,768 bytes (16,384 
words). 



The Program 
Counter 




Figure 11-4 PDP-11 Computer Memory 
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During processing, the assembler converts each program lan- 
guage statement into numerical data (the object code) and as- 
signs the data a relative storage location. The system linker 
will convert the relative storage locations assigned by the as- 
sembler to absolute storage locations in the computer memory.^ 
The location's associated number is called its address. As the 
assembler translates and assigns each statement, it updates the 
value of the program counter accordingly. 



The Symbol Table 



Since you may not know which locations, or how many loca- 
tions, the program needs, you use symbolic names (variables, 
constants, and labels) to represent individual locations and 
their contents. As the assembler processes the source program, 
it constructs a symbol table, which is a compiled list of all the 
symbolic names and labels that you have used within the pro- 
gram. The MACRO-11 assembler defines each symbolic name 
by assigning an address or data value, as appropriate, and adds 
the symbol definition to the symbol table. After assembly, you 
can refer to the symbol table, which is printed at the end of the 
assembly listing, to find all symbol definitions. 



Machine Language 
Code 



The third function of the assembler is to convert your 
MACRO-11 source language statements into machine lan- 
guage code (the object module). 



NOTE 

The following information will help you understand the 
assembly listing used later in this chapter. 

Machine language code is numerical data in the form of binary 
numbers (numbers composed of only the digits and 1). Binary 
numbers are appropriate because the digits and 1 can be eas- 
ily manipulated by the two-state electronic logic of the com- 
puter. 

For example, a typical assembled instruction in PDP-11 com- 
puter memory looks like this: 



location 


location 


address 


contents 


01000 


11000000 


01001 


11100101 



^The system linker is discussed in Chapter 12. 
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Since a single instruction requires two (or more) consecutive 
memory locations, the instruction is actually put together in 
memory in the following manner: 



high-order byte 
01001 11100101 



low-order byte 
11000000 01000 



Each individual digit of the instruction is called a bit (binary 
digit). A single memory location, called a byte, contains 8 bits; 
two memory locations, called a PDP-11 word, contain 16 bits. 

The byte in the even-numbered memory address is called the 
low-order byte and is stored first; the byte in the odd-numbered 
memory address is called the high-order byte and is stored next. 
Both bytes together form one PDP-11 16-bit word (Figure 
11-5). 

PDP-11 Word 



01001 



1110 10 1 



^W 



11 



01000 



etc. 



bit 



High-order byte 



Low-order byte 



Figure 11-5 PDP-11 Word 

The computer works in terms of 8-bit bytes and 16-bit words of 
binary data. However, binary numbers are generally too long 
and cumbersome to be used effectively by a programmer. But 
binary numbers can be easily represented as octal numbers 
(numbers composed of digits within the range to 7). Since 
octal numbers are closer to the familiar decimal number system 
and are much more readable than binary numbers, the pro- 
grammer more often uses octal numbers than binary numbers. 

Table 11-1 shows the decimal numbers through 10 and their 
respective octal and binary equivalents. Tables and formulas 
are available to calculate higher conversions. 

Thus, you can think of the binary instruction shown earlier in 
terms of its octal equivalent as follows (conversion is done from 
low-order to high-order byte in groups of three bits): 

high-order byte low-order byte 

01001 11100101 11000000 01000 



6 











162700(8) 
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A MACRO-11 assembly listing shows the addresses of memory 
locations and their contents as octal numbers. The octal num- 
bers represent the respective binary machine language code 
that makes up the object module. 

Table 11-1 Decimal/Octal/Binary Conversion 



Decimal 




1 
2 
3 
4 
5 
6 
7 
8 
9 
10 



Octal 





1 

2 

3 

4 

5 

6 

7 

10 

11 

12 



Binary 



000 
001 
010 

oil 

100 
101 
110 

111 

000 
001 
010 



ASSEMBLING 
THE MACRO-n 
PROGRAM 



In Chapter 5 you used the RT-11 editor to create a MACRO-11 
source program; you then stored it on your storage volume. 
Since a source program is in ASCII format, the next step is to 
use the MACRO-11 assembler to convert the source program to 
object code. 

Copy the MACRO-11 source program from the storage volume 
back to the system volume (which is the default volume for 
input/output operations). 

On your storage volume are two MACRO-11 source programs, 
the one you created, SUM.MAC, and the one provided for you, 
DEM0X1.MAC, which was renamed to EXAMP.MAC in Chap- 
ter 7. Which of these you should copy depends on the results of 
the source comparison you performed in Chapter 6. If the com- 
parison resulted in no differences except for the title lines, copy 
your own program (SUM.MAC) as follows: 

Long Command Format 



.COPYd 
From? 
To ? 



VOLS SUM. MACES 
SUM.MACdD 



Short Command Format 

.COPY UOLsSUM.MAC SUM.MAClHai 

However, if differences were listed in addition to the title lines, 
substitute the program EXAMP.MAC: 
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Long Command Format 

.COPY® 

From? yOL:EXAMP.MAC(REl 

To ? SUM.MAC(rS) 



Short Command Format 

.COPY yOLsEKAMP.MAC SUM, MAC® 



Whichever source file you copied now resides on your system 
volume under the name SUM.MAC and is the file that you will 
process with the MACRO-11 assembler. The command used to 
assemble a MACRO-11 source program is the monitor MACRO 
command. 

Use the MACRO command with its /LIST and /CROSSREFER- 
ENCE options to assemble your source program and produce a 
cross-referenced assembly listing. The system prompt asks you 
to supply the input file name. You can omit typing the .MAC 
file type, since the MACRO command assumes this file type 
unless you indicate otherwise. The system will automatically 
assign the name SUM.OBJ to the object module and SUM.LST 
to the listing file, and store both newly created files on the 
system volume. (The system volume is the default storage vol- 
ume for input/output operations.) 



MACRO 



Long Command Format 

.MACROdS 

Files? SUM/LIST/CROSSREFERENCE(aS 



Short Command Format 

.MACRO SUM/LIST/CROSSREFERENCE® 

Assembly begins. When it is finished, a message similar to the 
following prints on the terminal printer or screen: 

?MACRO-W-Erro rs detected: 6 
DK:SUM .DK:SUM/C = DK:SUM 

This message indicates that the assembler detected errors in six 
lines of the source program during processing. It helps at this 
point to look at the listing produced by the assembler for infor- 
mation. 



Long Command Format 

(Line Printer) 



(Terminal) 



.PRINTO 

Files? SUM.LST® 



.TYPE® 

Files? SUM.LST® 
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Short Command Format 

(Line Printer) 

.PRINT SUM.LSTdS 



(Terminal) 



I TYPE SUM,LST(i 



Your listing should look like the following example. An expla- 
nation of this listing follows. You should refer to the listing as 
you read the accompanying explanation. 

NOTE 

You do not need to understand the MACRO-11 lan- 
guage or the way this program works to successfully 
complete the exercises in this chapter. 



SUM. MAC VERSION 1 



MACRO V05.00 Saturday ( 



8-Jan-a3 09J21 Paae 1 

.TITLE SUM. MAC VERSION 1 
.HCALL .TTYOUTf .EXITf .PRINT 





7 




000106 








N = 70. 


iNO. 


OF 


DIGITS OF 'E' TO CALCULATE 




e 










i 


'E' = THE SUM OF THE 


RECIPROCALS OF THE FACTORIALS 




9 
10 

11 










' 


1/0! + 


1/1! + 1/2! + 


1/3! + 1/4! + 1/5! + ... 


M 


000000 








EXP: 


.PRINT 


tHESSAG 




; PRINT INTRODUCTORY TEXT 




12 


000006 


012705 


000106 






MOV 


*N.R5 




;no. of chars of 'e' to print 




13 


000012 


012700 


000107 




first: 


MOV 


#N+1.R0 




;no. of digits of accuracy 


U 


14 


000016 


012701 


000000 






MOV 


♦ArRl 




saddress of digit vector 




15 


000022 


006311 






SECOND. 


: ASL 


(?R1 




iDO MULTIPLY BY 10 (DECIMAL) 




16 


000024 


011146 








MOV 


GR1f-<SP) 




rSAVE *2 




17 


000026 


006311 








ASL 


eRi 




i*A 




IB 


000030 


006311 








ASL 


0R1 




i*B 




19 


000032 


062621 








ADD 


<SP) + .(R1U 




imii *10» POINT TO NEXT DIGIT 




20 


000034 


005300 








DEC 


RO 




fAT end of DIGITS? 




21 


000036 


001371 








BNE 


SECOND 




fBRANCH if NOT 




22 


000040 


012700 


000106 






MOV 


+N»RO 




fGO thru all placesf dividing 




23 


000044 


014103 






third; 


MOV 


-CR1>.R3 




fBY the places INDEX 




24 


000046 


012702 


177777 






MOV 


*-l.R2 




fINIT QUOTIENT REGISTER 




25 
26 
27 


000052 


005202 






FOURTH 


! INC 


R2 




iBUMP QUOTIENT 




000054 


160003 








SUB 


R0fR3 




JSUBTRACT LOOP ISN'T BAD 




28 


000056 


103375 








BCC 


FOURTH 




fNUMERATOR is ALWAYS < 10*N 




29 


000060 


060003 








ADD 


R0fR3 




!FIX REMAINDER 




30 


000062 


010311 








MOV 


R3>eRl 




(SAVE REMAINDER AS BASIS 




31 


















SFOR NEXT DIGIT 


AR 


32 


000064 


066167 


000000 


000000 




ADD 


R2-2(R1> 




^GREATEST INTEGER CARRIES 




33 


















fTO GIVE DIGIT 




34 


000072 


005300 








DEC 


RO 




;AT end OF DIGIT VECTOR? 




35 


000074 


001363 








BNE 


THIRD 




fBRANCH IF NOT 




36 


000076 


014100 








MOV 


-CRDfRO 




fGET DIGIT TO OUTPUT 




37 


000100 


162700 


000012 




fifth: 


SUB 


♦10., RO 




fFIX THE 2.7 TO .7 SO 




38 


















fTHAT IT IS ONLY 1 DIGIT 




39 


000104 


103375 








BCC 


FIFTH 




; (REALLY DIVIDE BY 10) 




40 


000106 


062700 


000072 






ADD 


*10.+'0,R0 




fMAKE DIGIT ASCII 


U 


41 


000112 


000000 








.TTYON 






(OUTPUT THE DIGIT 




42 


000114 


005011 








CLR 


eRi 




rCLEAR NEXT DIGIT LOCATION 




43 


000116 


005305 








DEC 


RS 




fMORE DIGITS TO PRINT? 




44 


000120 


001334 








BNE 


FIRST 




fBRANCH IF YES 




45 

46 
47 


000122 










.EXIT 






iUE ARE DONE 


K 


000124 


000107 






EXP! 


.REPT 


N+1 








4B 












.WORD 


1 




JINIT VECTOR TO ALL ONES 




49 












.ENDR 










50 






















51 


000342 


124 


110 


105 


MESSAG 


: .ASCII 


/THE VALUE OF E 


is:/ <15><12> /2./ <200> 






000345 


040 


126 


101 
















000350 


114 


125 


lOS 
















000353 


040 


117 


106 
















000356 


040 


105 


040 
















000361 


111 


123 


072 
















000364 


015 


012 


062 












SUM, 


.MAC 


VERSION 


1 


MACRO V05.00 Sa 


turdau 08-Jar.-83 


09121 Page : 


L-1 








000367 


056 


200 
















52 












.EVEN 










53 
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SUH.MAC VERSION 1 MACRO V05.00 Saturday 08-Jan-83 09:21 Paae S-1 
Cross reference table <CREF V05.00) 

,TTYON 1-41 

A 1-14 

EXP 1-11* 1-47* 1-54 

FIFTH 1-37* 1-39 

FIRST 1-13* 1-44 

FOURTH 1-25* 1-2S 

MESSAG 1-11 1-51* 

N 1-7* 1-12 1-13 1-22 1-47 

SECOND 1-15* 1-21 

THIRD 1-23* 1-35 

SUH.MAC VERSION 1 MACRO V05.00 Saturday 08-Jan-a3 09:21 Pade M-1 
Cross reference table (CREF VOS.OO) 

.EXIT 1-3* 1-45 
.PRINT 1-3* 1-11 
.TTYOU 1-3* 

SUH.MAC VERSION 1 MACRO V05.00 Saturday 08-Jan-83 09121 Paae E-1 
Cross reference table (CREF V05.00) 

A 1-32 

D 1-54 

H 1-11 1-47 

R 1-32 

U 1-14 1-41 

The first part of the Hsting has four logical sections, as follows: 



line 


octal 


octal statement line 


number 


memory 


instruction 




address 


value(s) 



The assembler assigns consecutive decimal line numbers to 
each line of the source program, including blank lines and com- 
ment lines. These numbers are used for reference purposes. The 
next column to the right shows the relative^ even-numbered 
octal memory (byte) addresses of storage locations assigned by 
the program counter to each instruction in the program. This 
program has been assigned relative memory addresses 
through 370. The third column (and possibly fourth and fifth) 
shows the octal equivalent of the assembled instruction or data 
value. An apostrophe following an octal value indicates a rela- 
tive value that must be modified before it can be used (the 
actual value is determined during linking). Finally, the source 
program as you created it appears in the right-hand portion of 
the listing. 

For example, look at line 18 of the listing: 

18 000030 00B311 ASL @R1 ;#B 

The instruction ASL @R1 is stored in relative memory loca- 
tions 30 and 31 as binary data (the comment, ;*8, is ignored): 

31 00001100 1100100 1 30 

6 3 11 



^The assembler assigns relative memory addresses to instructions. Actual 
addresses are not determined until the link operation is performed. Linking 
and address relocation are discussed in Chapter 12. 
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Some instructions require more than two memory locations; for 
example, those at lines 13 and 14. The number of memory loca- 
tions required depends upon the operation. 

Following the assembled code in the listing is the symbol table, 
an alphabetical listing of user-defined symbols and labels in the 
program and their respective definitions. Symbols are defined 
as values. For example, the symbolic variable name N is de- 
fined (in line 7) as 000106(octal) or 70(decimal), an absolute 
value. Labels are defined as addresses. The symbolic label 
FIRST is defined (in line 14) as 000012, a relocatable address 
(the R following 000012 in the symbol table indicates that the 
address will be relocated or modified during linking). A row of 
asterisks next to any symbolic name in the table indicates that 
for some reason — possibly a programming error — the as- 
sembler could not define the symbol. 

At the very end of the symbol table (where the . ABS. occurs) is 
the program's size information (or synopsis) in terms of the to- 
tal number of octal storage locations it requires (in this case, 
372). Following is the number of errors detected, and the 
amount of free and used memory pages (statistics provided by 
the assembler). 

Following the symbol table is the cross reference (CREF) list- 
ing. The CREF listing is optional — as is the assembly 
listing — but provides you with useful reference and debug- 
ging information, especially if the program is large. The CREF 
listing can contain several kinds of tables of reference informa- 
tion, each beginning on a new page. The default tables are the 
three shown here. 

Every reference in a CREF table shows the page number of the 
listing (in the preceding example, all references are on page 1), 
followed by the appropriate line number. A number sign follow- 
ing a line number indicates that this line is where a label or 
symbol definition occurs. 

The first CREF table shown here lists alphabetically all user- 
defined symbol and label references. 

The second CREF table lists alphabetically all macro symbol 
references. (Macro symbols are a special feature of the 
MACRO-11 assembly language; they are described shortly.) 

The third CREF table lists alphabetically the codes of the er- 
rors detected during assembly. These errors must be corrected 
before you can run the program. 

Now that you are familiar with the format of an assembly list- 
ing, go back to the beginning of the example listing to deter- 
mine what this program should do. 
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The first two comment lines (preceded by semicolons) indicate 
that the program calculates the value of "E', which is the sum of 
the inverse of the factorials between 1 and infinity. The algo- 
rithm used in this program is somewhat complicated (this was 
necessary to keep the program reasonably short). 'E' is calcu- 
lated one digit at a time by using a difference function between 
its actual value and the current approximation for each new 
digit. The program forms: 

1 + (1 + (1 + ... + (1 + ((1 + (l/N))/(N-l))/(N-2))/.../2)/l) 

and is 2.11111... in the inverse factorial base system, which is 
the first sum shown in the program listing. 

The statements between lines 1 through 7 define initial states 
to the assemblers, such as the value of N, and designate the 
macros that will be used throughout the program. 

Macros, from which the MACRO-11 language processor derives 
its name, are a useful feature of the MACRO-11 assembly lan- 
guage. You can define as a macro any recurring sequence of 
coding instructions. By giving the macro a name, you can there- 
after call it from any other part of the program by using a 
single language statement. 

In addition to the macros you define yourself, the RT-11 system 
provides system macros that your programs can access. System 
macros are defined in a special system library file called SYS- 
MAC.SML (SML stands for System Macro Library). SYS- 
MAC.SML is part of the RT-11 operating system and is stored 
on the system volume. If you request a system macro from your 
source program, the MACRO-11 assembler automatically 
searches SYSMAC.SML for the required information. 

The system macros defined in SYSMAC.SML are calls to cer- 
tain services performed by the RT-11 monitor, such as terminal 
handling, input and output operations, program termination, 
file capabilities, and so on. The portion of the monitor that per- 
forms these services, or that is capable of getting the necessary 
program code to perform these services, is always in memory 
and is therefore called the resident monitor. Thus, whenever 
your source program is in memory and is to be executed, the 
resident monitor is also there with its services. 

You communicate the need for a monitor service by issuing a 
programmed request in your source program. A programmed 
request consists simply of a macro call to a specific macro de- 
fined in SYSMAC.SML. The macro expands into the appropri- 
ate machine language code, which, during program execution, 
makes a request to the resident monitor to supply the desired 
service. 
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You specify all programmed requests that you intend to use in 
your source program in an .MCALL statement, like the one 
shown at line 3 in the listing. For example, the programmed 
request .TTYOUT requests the monitor to print an ASCII char- 
acter on the console terminal. During assembly, the .TTYOUT 
macro in SYSMAC.SML is expanded into machine language 
code. During program execution this code requests the resident 
monitor to take the indicated ASCII character and send it to 
the console terminal. 

Line 12 in the program uses another programmed request, 
.PRINT, to print a message on the terminal. 

Lines 13 through 15 are initialization instructions: they set ini- 
tial values in three of the special registers. Lines 16 through 22 
represent a routine that does a multiplication by 10. Lines 23 
and 24 are setup instructions for the division routine of lines 25 
through 28. Lines 29 through 35 save the quotient and remain- 
der. Lines 36 through 40 print the digits of E. Lines 43 and 44 
count the number of digits. 

The statements at lines 47 through 49 reserve a buffer area (a 
series of locations in memory) to be used by the program and 
therefore not to be assigned to other instructions. The state- 
ment at line 51 provides the data for printing the ASCII text 
message THE VALUE OF E IS: 2. 

This program, however, contains errors. The assembler discov- 
ered six lines with errors that prevent the program from assem- 
bling properly. The assembler flags (points out) errors by print- 
ing a code letter in the assembly listing or on the terminal if no 
listing is requested.^ 

The first error occurs at line 12 and is an M error. This means a 
label was defined more than once. You can refer to a label any 
number of times, but you may define it only once. By looking at 
the CREF user symbol table, you can see that the label is de- 
fined at line 12 and again at line 47; one of these definitions is 
wrong. Examination of the program logic reveals that the defi- 
nition at line 12 is correct. Before deciding how to change line 
47, though, check the other errors to see if one of them indicates 
what should be done. In fact, the next error encountered (line 
15) shows what is wrong. A U error identifies an undefined 

oj i.i.xKf\j±, A. jLio xa.Kr\Sx J. i io X oxox oxxv^c^wi. XXX xxixo J-ty J jau.1; xa xxc v ex viC" 

fined within the program. It should be defined logically at line 
47. Therefore, line 47 should be changed to read: 

As .REPT N+1 



^Kefer to the RT-11 System Message Manual for greater detail about any 
system messages printed during normal system use. 
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Thus, this one change eliminates three errors flagged by the 
assembler; those at lines 12, 15, and 47. 

The next error occurs at line 32. Actually, the assembler 
flagged two errors here. An A error indicates an addressing 
problem and an R error indicates a register error (invalid use of 
a register, a special PDP-11 storage feature). If you look at the 
language statement in line 32, you can see that the ADD opera- 
tor is followed by one operand. However, ADD is an instruction 
that requires two operands (two values to be added together) 
separated by a comma. This statement simply contains a typing 
error, which can be corrected by inserting a comma between the 
R2 and the -2(R1). Thus, changing the line as follows both 
corrects the addressing problem and eliminates the invalid reg- 
ister expression: 



ADD 



:(Ri) 



At line 41 is another undefined symbol, the macro symbol 
.TTYON. Since the program designated the macro symbol 
.TTYOUT in line 3, this error indicates a misspelling. Correct 
line 41 to read: 

, TTYOUT 

Finally, a D error occurs in line 54. This indicates that refer- 
ence was made to a symbol that is defined more than once. This 
error has already been eliminated as a result of the correction 
made to line 47. 

Thus, by changing the three lines indicated, you can correct all 
the errors flagged during assembly. So the next step is to edit 
the appropriate lines in the source program. If necessary, re- 
view the editing commands in Chapter 5, and then edit the file 
SUM.MAC on your system volume so that the three lines indi- 
cated are error-free. Do not rename the file. When you are 
ready, reassemble the program, using the MACRO command, 
and obtain a new object module and a new listing. This time the 
program should assemble without error. If errors occur, you 
have not edited the program correctly. Compare listings and try 
to correct your errors, or go back to the beginning of this chap- 
ter and repeat the demonstration. 



r^rxfvw^n «-» 



«J 
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itself be incomplete. It may need to be joined with other object 
modules or library files to form a complete functioning 
program,^ since all required object modules must be joined be- 
fore the program can work. 



MODULES 
TOGETHER 



^Chapters 12 and 13 give more information on linking files and using library 
files, respectively. 
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Thus, you must next link the SUM object module with any- 
other object modules it requires. However, the only file used by 
this program was the macro library file SYSMAC.SML, and it 
was used during assembly. So in this case, you do not need to 
join the SUM object module with any other modules. 

NOTE 

Some other MACRO-1 1 programs that you write later 
may reference system subroutines supplied in the sys- 
tem subroutine library, SYSLIB.OBJ. Programs that ref- 
erence these routines must be linked with the system 
subroutine library to satisfy external references. If SYS- 
LIB.OBJ is not present on your system volume, follow 
the guidelines in the section of Appendix B entitled Using 
the LINK Volume. 

Even though SYSLIB is not required for SUM. OBJ, you must 
still link the file. The link operation, in addition to joining ob- 
ject modules together, also assigns absolute memory addresses 
to the relative addresses calculated by the MACRO-11 assem- 
bler. Since the memory addresses of one object module must be 
relocated to accom.modate addresses used in another object 
module, the link operation serves to resolve all address 
changes. The result of the link is a memory image load module, 
with all module links resolved and all absolute memory ad- 
dresses and storage information assigned (Figure 11-6). The 
memory image module, then, is actually a picture of what com- 
puter memory looks like just before program execution. 
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To link the object modules, use the LINK command. The system 
prompts you to enter the names of the input object modules to 
be linked together. You can omit typing the .OBJ file type in 
the command line since the LINK command assumes this file 
type for input. After you have entered the input information, 
the system begins linking the object module. You do not have to 
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specify an output file, since the system automatically assigns 
the file name of the first input file and a file type of .SAV to the 
output file. 

Long Command Format 

.LINK® 
Files? SUM® 

Short Command Format 

.LINK SUM® 

Any messages printed inform you of error conditions discovered 
during the link operation (for example, if you fail to specify all 
the necessary input object modules). However, assuming you 
edited your source program correctly and that it assembled 
without error, it should also now link without error. 

A load module is one that you can run on the system. Unless 
your program contains logic errors that prevent it from running 
properly (errors that the system cannot always detect), running 
the .SAV version of your program should produce the results 
you intended. However, if logic errors exist within your pro- 
gram, running the program will produce either erroneous re- 
sults or none at all. If this is the case, you must study the 
source program, rework it, reedit it, then perform the assembly 
and link operations again. 



If your MACRO-11 program is error-free, running the .SAV 
version should produce the expected results. In this demonstra- 
tion, running the SUM.SAV file should produce a value on the 
terminal that is the constant E (2 followed by 70 digits). 

To execute the MACRO-11 demonstration program, use the 
monitor RUN command. You can omit typing the .SAV file 
type, since the RUN command assumes this file type. Type the 
following, and note the results printed on the terminal: 

ijOUff and oxiort Commaiid Format 

.RUN SUMSB 

THE MfiLUE OF E IS: 

2. 5/G0B/B0B237. 230 131 4. 06525/ 1304^0275535025. 7 1«77737352744745^05502. 5^4 



RUNNING THE 
MACRO-11 
PROGRAM 



1 ou can see tnat sometning is wrong. Slashes and periods ap- 
pear in the result, indicating that an error still exists some- 
where in the program. 

Programming errors, called "bugs," can be difficult to find and 
fix. A debugging aid called ODT (On-line Debugging Tech- 
nique) is described in Chapter 14. You will use it to correct the 
program's final error and to rerun the program. For now, how- 
ever, the error will be pointed out and explained. 
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Look at line 40 in the assembly listing. Notice that the instruc- 
tion in this line converts a digit into the appropriate ASCII code 
before printing it on the terminal. To do this, the constant 10 is 
added into the value of the digit already stored in memory, and 
then the value is converted — via '0, the ASCII code for 
— to an ASCII code that can be printed. Unless you ex- 
plicitly designate a value as decimal, however, the assembler 
assumes all values used in the program are octal. Therefore, it 
interprets the constant as lO(octal) or 8(decimal), and adds the 
wrong value every time. The conversion consequently causes 
the codes of the ASCII characters / and . to be used as results in 
some cases. The codes of other digits, while representing nu- 
meric values, are also off by two. To correct this error, you must 
insert a period after the 10 in line 40. The period instructs the 
assembler to accept the constant value 10 as a decimal value. 



COMBINING 
OPERATIONS 



EXECUTE 



To produce program results, you first assembled the 
MACRO-11 source program, SUM.MAC, then linked it, and 
finally ran the resulting .SAV file, SUM.SAV. You can combine 
these three operations using one monitor command, the EXE- 
CUTE command. 

NOTE 

In order to use the EXECUTE command, the following 
files must be present on your system volume: 

SUM.MAC 
MACRO.SAV 
LINK.SAV 
SYSLIB.OBJ 

The last file, SYSLIB.OBJ, is required only if the 
MACRO-1 1 program you need to link refers to routines 
that are contained in the system library. The program 
used in this demonstration, SUM.MAC, does not require 
SYSLIB.OBJ. 

The EXECUTE command instructs the system to select the ap- 
propriate language processor, then process, link, and run the 
program. There are several ways to establish which language 
processor the EXECUTE command invokes. One way is to spec- 
ify a language-name option, such as /MACRO, which invokes 
the MACRO-11 assembler. Another way is to omit the lan- 
guage-name option and explicitly specify the file type for the 
source file. The EXECUTE command then invokes the lan- 
guage processor that corresponds to that file type. Specifying 
the file SUM.MAC, for example, invokes the MACRO-11 as- 
sembler. A third way to establish the language processor is to 
let the system choose a file type of .MAC, .DEL, or .FOR for the 
source file you name. If, for example, you specify the file SUM, 
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the monitor searches device SY: (your system device) for the 
files SUM.MAC, SUM.DBL, and SUM.FOR, in that order. If it 
finds a file named SUM.MAC, it invokes the MACRO-11 as- 
sembler to process the file. For example, to combine the assem- 
ble-link-run operations you performed in this chapter, you use 
the following command: 

Long Command Format 

• EXECUTE® 

Files? SUM/LIST/CROSSREFERENCE® 

Short Command Format 

•EXECUTE SUM/LIST/CRDSSREFERENCEBH) 
THE yflLUE OF E IS: 

2. 5/B0B/B0B237. 230 131 a, OB525/130aa0Z755350Z5. 7 1477737352744745^05502. 544 

Notice how you use the /LIST and /CROSSREFERENCE op- 
tions following the file name to request both an assembly and a 
cross-referenced listing. 



EXECUTE 

Combine the assemble-link-run operations into one com- 
mand. 

EXECUTE file/MACRO 

Combine the process-link-run operations into one command, 
and specify the input file to be a MACRO-11 file. 

EXECUTE/CROSSREFERENCE 

Produce a cross-referenced listing file. 

EXECUTE/LIST 

Produce a listing file of the source program. 

LINK 

Link individual object modules together to form a complete 
program and produce a load module. 

MACRO 
Assemble the MACRO-11 source program, and produce an 
object module. 

MACRO/CROSSREFERENCE 

Assemble the MACRO— 11 source program, and produce both 
an object module and a cross-referenced listing file. 

MACRO/LIST 

Assemble the MACRO-11 source program, and produce both 
a listing on the line printer and an object module. 

RUN 

Run the indicated load module. 



SUMMARY: 

COMMANDS TO 

RUN MACRO-11 

PROGRAMS 
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FILE MAINTENANCE Before continuing, you should perform the necessary file main- 

tenance operations. Obtain a directory of all files on your sys- 
tem volume that have the name SUM, regardless of file type; 
these files were created as a result of the exercises in this chap- 
ter. 

Long and Short Command Format 



.DIRECTORY 


SUM, 


, *® 










08-Jan-83 














SUM .BAK 


3 


08-Jan-83 


SUM 


.SAM 


2 


OS-Jan-83 


SUM .LST 


9 


08-Jan-83 


SUM 


.MAC 


3 


08-Jan-B3 


SUM .OBJ 


1 


08-Jan-83 










5 Files , 


18 B] 


Locks 










aSO Free ! 


blocks 











The fact that you have corrected errors in the source file of 
SUM.MAC makes the version of that file on your storage vol- 
ume obsolete. Therefore, transfer the updated copy from your 
system volume back to VOL:, replacing the copy of SUM.MAC 
on the storage volume with the new version. 

Long Command Format 

.COPY® 

From? SUM.MAC® 

To ? VOLsSUM.MAC® 

Short Command Format 

.COPY SUM.MAC yOLsSUM.MACEB 

Similarly, transfer SUM.SAV and SUM.OBJ to your storage 
volume. This allows you to rerun the MACRO-11 program 
without reassembling and relinking the source. 

Long Command Format 

.COPY® 

Frohi? SUM.SAUtSUM.OBJ® 

To ? MOLs® 

Files copied! 
DKsSUM.SAV to MOLsSUM.SAM 
DKiSUM.OBJ to yOL:SUM.OBJ 

Short Command Format 

.COPY SUM.SAV. SUM. OBJ MOL:® 
Files copied! 
DK!SUM.SAV to UOL!SUM.SAV 
DK!SUM.OBJ to UOL!SUM.OBJ 

Once you have transferred to your storage volume the files you 
want saved, delete from the system volume those you no longer 
need (that is, all the SUM files). 
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Long Command Format 

.DELETE/NOOUERYiS) 
Files? SUM.*® 



Short Command Format 

.DELETE/NOOUERY SUM.*® 

Notice that the /NOQUERY option suppresses confirmation 
when wildcard construction is used. 

Finally, obtain an up-to-date directory listing of your storage 
volume so that you can see its current status. 

Long and Short Command Formats 

.DIRECTORY VOLn® 



08-Jan-83 




















SUM .SAU 


2 


08- 


-Jan-B3 


SUM 


.OBJ 


1 


08- 


- J a n ■ 


-83 


EXAMP .FOR 


2 


28- 


-ALi£f-B2 


EXAMP 


.MAC 


3 


2B- 


- A 1.1 3 • 


-82 


GRAPH .FOR 


2 


OB- 


-Jan-83 


GRAPH 


.LST 


8 


08- 


- Jarl• 


-83 


GRAPH .OBJ 


IB 


OS- 


- Jai-i-B3 


GRAPH 


,SAy 


21 


08- 


- Jan- 


-83 


SUM .MAC 


3 


08- 


-Jari-83 


MATCH 


.BAB 


3 


08- 


-Jan- 


-83 



10 Files. Gl Blocks 
4701 Free blocks 



This completes the MACRO-11 demonstration. Continue now 
to Chapter 12 to learn more about the link operation. 
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CHAPTER 12 

LINKING OBJECT PROGRAMS 



Programs that you write in the MACRO-11 and FORTRAN IV 
programming languages require additional processing after 
their conversion to object format. Before you can run these pro- 
grams on the system, you must link them. The link operation: 

® Joins together the object modules that use a symbol with the 
object module that defines it. 

® Relocates individual object modules as necessary and assigns 
absolute (permanent) memory addresses; it can also define an 
overlay structure. 

® Produces a load module and an optional load map (Figure 
12-1). 



OBJECT 
MODULE(S) 



LINK 



-^ 



LOAD 
MODULE 



LOAD MAP 
(OPTIONAL) 



Figure 12-1 Link Functions 

Program linking gives you the advantage of a modular ap- 
proach to programming. You can create an entire program as a 
series of smaller, independent subprograms. One of these is 
written as the main, or controlling, program, and the rest as 
subordinate subprograms and subroutines. You use a language 
processor to translate each part of the program into an object 
module. Then you use the linker to join all the object modules 
together into a complete, functioning unit. 

Modular programming makes program creation and debugging 
easier. For example, several programmers can simultaneously 
work on a single program, each creating a portion of it. The 
individual portions, or subprograms, can be processed and 
linked with test programs and debugged for logic errors sepa- 
rately. Then all the object modules can be joined together to 
form a complete program that can be tested as a whole. If errors 
occur at this stage, only those object modules with errors need 
be debugged and changed. 
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In addition, modular programming allows you to make use of 
library files. These are files containing subprograms and sub- 
routines that have been debugged. After you join library files 
with your program at link-time, their routines can be used by 
your program as needed. 



RESOLVING 
SYMBOLIC AND 
LIBRARY 
REFERENCES 



The linker reads through all the object modules that you indi- 
cate as input to the LINK command. It gathers and evaluates 
information (provided to the modules by the language proc- 
essor) that is necessary for program linking. For each input 
module, this information includes the object code, information 
needed for relocation, the relative address of the first instruc- 
tion, the global symbols used, and the absolute length of each 
program and program section. 

One of the linker's first functions is to resolve all user-defined 
symbolic references and library references in the joined 
routines. There are two types of user-defined symbols — in- 
ternal symbols and global symbols. 

Internal symbols are limited to the object module in which they 
appear; thus, they cannot be referenced from or defined in any 
other module. A program containing only internal symbolic 
references — like those in the demonstration program in 
Chapter 11 — is complete in itself and does not need to be 
joined with any other object programs at link-time. Thus, in- 
ternal symbols are not resolved at link-time because they have 
already been resolved by the language processor. 

Global symbols, on the other hand, are the key to modular pro- 
gramming. Global symbols provide the communication between 
object modules. Such symbols may be symbolic labels to instruc- 
tions, symbolic labels to data, or symbols that are equated to a 
value or constant. Global symbols are defined in one object 
module and referenced from other object modules that have 
been separately assembled or compiled. Such symbols must be 
designated as global in the source code. The following segment 
of MACRO-11 assembly language code illustrates the use of 
global symbols: 



HACRO <J05.00 SATURDAY 08-JAN-S3 08:^2 PAGE 1 



1 










.GLOBL 


A. C. VALUE 


iOECLARE A. C. AND VALUE 


2 














iAS GLOBAL BYMBDLS 


3 


000000 


013500 




At 


MOU 


n(R5?*.P0 


'GLOBAL SY.150L A !S DEFI.NED 


a 














(HERE AND CAN BE REFERENCED 


5 














(FROM OTHER MODULES i PROBABLY 


B 














toy A SUBROUTINE CALL 


7 


000002 


01G701 


OOOOIG 




HOV 


LOCAL. Rl 


(LOCAL IS AN INTERNAL SYMBOL 


B 














(DEFINED AND REFERENCED ONLY 


9 














(WITHIN THIS MODULE 


10 
11 


000006 


000000 


000007 


OOOOOOG 


USR 


PC.C 


(CALL TO GLOBAL ROUTINE Cr 
(DEFINED IN ANOTHER MODULE 


12 


ooooia 


013501 






HOV 


B[RS)+,R1 




13 


OOOOIE 


005003 






CLR 


R3 




la 


000020 


000207 






HTS 


PC 




15 


000022 


000011 




VALUE t 


.UORD 


11 


[GLOBAL SYMBOL VALUE IS USED TO 


IB 














(REFERENCE THIS DATA LOCATION 


17 


00002d 


177777 




LOCAL: 


.MORD 


177777 


(INTERNAL SYMBOL USED FOR DATA 


IB 




000001 






.END 







12-2 



Linking Object Programs 



While internal symbolic references, such as LOCAL in the ex- 
ample, can be resolved by the assembler or compiler within the 
single program unit, global references, such as C, cannot. They 
require other object modules. During translation, the language 
processor notes in the object module those symbols that are 
global. During linking, the linker keeps track of the global ref- 
erences and definitions found in all the object modules. As 
linking proceeds, it makes the appropriate correlations and 
modifies instructions or data as necessary. After linking, the 
linker prints on the terminal a list of all symbolic references 
that were not resolved (undefined globals), either because of a 
programming error or because all necessary object modules 
were not included in the linking process. 

References to library files also involve the use of global sym- 
bols. You access the routines in a library by naming a routine 
as a global symbol in the source code of your program. You then 
link your program with the appropriate library file, and the 
linker resolves the library references just as it does any global 
symbol. Library usage is discussed in greater detail in Chapter 
13. 



A second important function of the. linker is to "fix" the relative 
memory addresses so that they are absolute.^ The object module 
represents translated source instructions that have been as- 
signed memory addresses relative to a base address of 0. 

Look back at the assembly listing in Chapter 11. Note the 
second column; these addresses are relative to a base address of 
0. Thus the first instruction is assembled at relative address 0, 
the second at relative address 6, and so on. A program cannot 
actually be stored and run in memory using locations relative 
to address 0, however, because system information is already 
stored in some of these locations. For example, the RT-11 oper- 
ating system uses byte addresses 40 through 57 to store infor- 
mation about the program currently executing. In addition, the 
RT-11 operating system uses locations in the upper range of 
memory for storing the resident monitor. Thus, the linker must 
assign memory addresses to your program that are not already 
in use or that will not be used during program execution. It 
must, therefore, assign absolute m.em.ory addresses to the rela- 
tive addre.'=!ses assierieri! hv thp Ian cf nacre rimrpaan-r 

The linker normally starts assigning memory addresses at ad- 
dress 1000, since this begins a large section of free memory 



^FORTRAN IV and BASIC-11 users who have not performed the demonstra- 
tion in Chapter 11 may wish to read the section in that chapter entitled The 
MACRO-11 Language Processor. That section explains the concept of con- 
verting and storing instructions in computer memory. 



PROGRAM 

RELOCATION 

AND ADDRESS 

ASSIGNMENT 
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space. So, to obtain the actual addresses used for program 
loading, you must add the relocation constant 1000 to each rela- 
tive address shown in the assembly listing. 

A conflict arises when several individually processed object 
modules are linked together. The linker cannot assign memory 
addresses starting at 1000 to every module, since address as- 
signments of one would then override those of another. How- 
ever, part of the information that the language processor calcu- 
lates and passes to the linker is the size of each program section 
in each module. So the linker simply adds this size into the 
relocation constant for each module and assigns higher ad- 
dresses, appropriately modifying the relative location of all in- 
structions and data as necessary to account for the relocation of 
each individual module. Figure 12-2 illustrates the relocation 
that must occur to accommodate object modules linked 
together.^ 



372 (octal) 
bytes 

370 




40 



SUBONE 



42 (octal) 
bytes 



166 



SUBTWO 



170 (octal) 
bytes 



Relative addresses of three 
assembled/compiled programs 




1000 


RESERVED 


1370 


PROG 


1372 
1432 


SUBONE 


1434 
1622 


SUBTWO 


1624 





Absolute addresses of three 
linked programs 



Figure 12-2 Object Module Relocation 



ABSOLUTE AND 
RELOCATABLE 
PROGRAM SECTIONS 



Just as global symbols allow you to create an entire program, 
using several individual object modules, program sections allow 
you to create an object module as a series of individual sections. 
The advantages gained through the sectioning of programs re- 
late primarily to control of memory allocation, program modu- 

^A load map for this relocation example is shown later in the chapter. 
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larity, and more effective partitioning of memory. The linker 
processes the program section information in the object mod- 
ules as directions on how to create the executable program 
image. 

The FORTRAN IV and MACRO-11 language processors insert 
program sectioning information into the object module. The 
FORTRAN IV language processor does this automatically when 
program sectioning is implied by the source language state- 
ments in a user program. For example, FUNCTION, SUBROU- 
TINE, and COMMON statements result in the production of 
program section directives. In MACRO-11 assembly language, 
you are responsible for explicitly directing the assembler to 
output program section information for the linker. You do this 
through the .PSECT (or .CSECT and .ASECT) MACRO-11 as- 
sembly language statement. 

Some of the basic functions associated with program sections 
are: 

1. Instructions or data can be placed in absolute locations in 
memory. The named absolute program section (. ABS.) al- 
lows you to instruct the linker as to exactly where to place 
program code or data. Declaring a section as part of the 
absolute program section instructs the assembler or com- 
piler to use the internal value of the program counter as the 
physical memory address to be assigned after linking. This 
section is processed relative to absolute memory address 
and is not relocated at link time. 

2. Named relocatable program sections are used to group data 
or instructions into logical portions of memory. The FOR- 
TRAN IV COMMON statement invokes this construct to 
allow access to named data areas from many separate 
routines. Declaring a section as part of a named relocatable 
program section causes the section to be processed at relo- 
catable address 0. Such sections are relocated by the linker. 

3. If you do not care about having exact control over where a 
portion (section) of a program will be placed in memory, use 
the blank program section — a special program section that 
the linker treats as relocatable. The linker decides where to 
place this program section in the loadable memory image. 
The blank program section is the default for a MACRO-11 
source program and remains in effect until an explicit pro- 
gram section is identified (the program example in Chapter 
11 used the blank program section). 

4. A program section can be identified as an instruction sec- 
tion. The linker, using this information, can provide auto- 
matic loading of declared overlay code when needed by the 
executing program (this will be discussed in more detail). 
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The language processor, then, actually maintains several pro- 
gram counters — one for the absolute program section, one for 
the unnamed relocatable program section, and as many as 
needed (ma,ximum is 254) for named relocatable program sec- 
tions. The assembled example that follows helps explain this 
concept. 



MACRO V05.00 SflTURDflY oa-JflN-83 09:0a PAGE 

















iUNNAMED RELOCATABLE PROGRAM 
















;SECTION IS DECLARED (BY DEFAULT) 
















i(". PSECT" IS ASSUMED) 


000000 


005000 






START! 


CLR 


RO 




000002 


012701 


00003a' 






HOO 


•BEG.Rl 




OOOOOG 


0S2I00 






LOOP! 


ADD 


(R1)+.R0 




OOOOIO 


022701 


ooooaa' 






CMP 


■BEG+10,R1 




ooooia 


10037a 








BPL 


LOOP 




OOOOIG 


0127B7 


002000 


000020 




MOV 


02000. ADDR 




00002a 


005003 








CLR 


R3 




000000 










.PSECT 


CLEAR 


iNAHED RELOCATABLE PROGRAM 


000000 


012703 


000100 






HDV 


al00>R3 


iSECTION IS DECLARED (VIA ".PSECT NAME' 


oooooa 


012701 


ooooaa' 






MOV 


■•ADDRiRl 




000010 


005021 






AGAIN: 


CLR 


(Rl) + 




000012 


005303 








DEC 


R3 




ooooia 


001375 








BNE 


AGAIN 




000000 


ooooa2 








.flSECT 
,=02 




iADSOLUTE PROGRAM SECTION 
IDECLAREO [VIA ".ASECT") 


000032 


001000 








.UORO 


1000 


TTHE VALUE 1000 HILL BE 

iSTDRED IN ABSOLUTE MEMORY LDCATIN az 

(WHEN THE PROGRAM IS EXECUTED 


000026 










.PSECT 




IBACK TO UNNAMED RELOCATABLE 


000026 


005267 


000012 






INC 


ADDR 


SPRDGRAM SECTION 


000032 


000000 








HALT 






00003a 


000001 


000002 


000003 


BEG; 


.MORD 


1 .2. 3. a 




ooooa2 


oooooa 














ooooaa 


000000 






ADDR: 


■ UORD 








iNOTE THAT YDU CAN WRITE LANGUAGE STATEMENTS THAT WILL BE LOADED 
rCONTIGUOUSLY IN MEMORY. BUT DO NOT NECESSARILY OCCUR CONTIGUOUSLY 
UN THE SOURCE PROGRAM (I.E.. THE CODE AT LINES 1-10 AND 22-23) 
.END 



Since the system does not know at assembly (or compile) time 
into which actual memory locations each relocatable section 
goes, all references among sections (see line 18) are relative to 
the base of the section. This information is then passed to the 
linker so that it can make the appropriate adjustments at link- 
time. 



The Overlay Feature 



The RT-11 linker is also capable of handling the special reloca- 
tion and address assignments that are required whenever you 
indicate that an overlay structure is needed. An overlay struc- 
ture is necessary when you write a program that is too large to 
fit in the available memory of your system. You write the pro- 
gram in discrete parts (some programming restrictions must be 
observed) so that your program can subsequently be executed in 
parts. Some of these parts, or segments, are allowed to share 
memory with other segments, thus reducing the overall 
memory requirements of the program. One segment of the pro- 
gram is called the root segment and must remain in memory at 
all times. The root segment contains the necessary information 
for use by the other segments of the program, called overlay 
segments. Overlay segments are stored on storage volumes and 
brought into memory as needed. The purpose of the overlay 
structure is for parts of the program to share the available 
memory in such a way that when one part is complete, it is 
overlaid (and therefore erased) by another. 

You indicate how to plan to overlay your program by using the 
/PROMPT option in the LINK command line. The linker then 
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creates a load module that contains the necessary information 
for loading the appropriate segments as needed during execu- 
tion. The RT-11 System Utilities Manual explains the overlay 
feature in more detail. You need not specify an overlay struc- 
ture for the examples demonstrated in this chapter. 
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The load module is the result of the linking processes described 
so far: joining object modules, resolving symbolic and library 
references, relocating object modules, assigning absolute ad- 
dresses, and creating an overlay structure if required. The load 
map is essentially a synopsis of the load module — that is, what 
memory looks like when the program is loaded and ready to be 
executed!. 

In Chapters 9 and 11, you produced load modules, but you did 
not request load maps. You obtain a load map by using the 
/MAP option with the LINK (or EXECUTE) command. At this 
time, relink the FORTRAN IV or MACRO-11 object module 
that you stored on VOL: and use the /MAP option to produce a 
load map.^ The load map is created as a file on the system 
volume, which is the default storage volume for input/output 
operations. The load map has the name of the first input 
module and a file type of .MAP. 

Long Command Format 

MACRO-11 object module: 

,Limm 

Files? yOLsSUM/HAPSai 

FORTRAN IV object module, if FORLIB is not included in 
SYSLIB: 

.LINK® 

Files? SYSLIB >FORL I BfMOL 5 GRAPH/MAP® 

FORTRAN IV object module, if FORLIB is included in SYSLIB: 

,Limm 

Files? VDLsGRAPH/MAPiSi 



PRODUCING 

A LOAD MODULE 

AND A LOAD MAP 



/MAP 



snori uommana i< ormat 

MACRO-11 object module: 

.LINK yOLs SUM/MAP® 

^FORTRAN IV users who followed the special instructions in Appendix B for 
loading the LINK volume should check that this volume is loaded in device 
unit 0. FORTRAN IV users who have a special FORTRAN IV language vol- 
ume, but not a LINK volume, should make sure that the FORTRAN IV vol- 
ume is now loaded in device unit 0. 
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FORTRAN IV object module, if FORLIB is not included in 
SYSLIB: 

.LINK SYSLIB»FORLIB»yDL!GryAPH/MAP(aSI 

FORTRAN IV object module, if FORLIB is included in SYSLIB: 

.LINK MOLiGRAPH/MAPdl) 

Now list the .MAP file on either the line printer or terminal, 
choosing the appropriate command: 



Long Command Format 

(Line printer) 
MACRO-11 object module: 

.PRINTESI 

Files? SUM, MAP® 



(Terminal) 



.TYPEdD 

Files? SUM.MAPiH 



FORTRAN IV object module: 

.PRINT® 

Files? GRAPH. MAP® 



.TYPE® 

Files? GRAPH, MAP(i 



Short Command Format 

(Line printer) 
MACRO-11 object module: 

.PRINT SUM. MAP® 



(Terminal) 



.TYPE SUM. MAPS 



FORTRAN IV object module: 

.PRINT GRAPH. MAP® 



.TYPE GRAPH. MAP® 



For your convenience, both maps are provided here. In addition, 
a load map of the relocation example used in Figure 12-2 is also 
provided. 

RT-ll LINK V08.00 Load Map Saturday 08-J3ri-83 lOtOO PaSe I 
SUM .SAV Title: SUM. MA Ident! 



Caf^+ 1 nt-i iiririf 



Global Value Global Mslue Global Value 



. ABS. 000000 001000 = 256. words (RWr I iGBLr ABS jOVR) 

001000 000372 = 125., uords (RU> I >LCLrREL>CON) 

Transfer address = OOlOOOr Hish limit = 001370 = 380. words 

RT-ll LINK V08.00 Load Map Saturday 08-Jan-83 10;il Pasie 1 

SYSLIB. SAV Title! .MAIN. Ident! F0RV02 

Section Addr Size Global Value Global Value Global Value 

. ABS. 000000 001000 = 256. words (RUr I >GBL» ABS. OVR) 

$USRSU 000000 $RF2A1 000000 JHRDWR 000000 

.VIR 000000 JNLCHN 000006 $SYSV* 000012 

tUASIZ 000152 *LRECL 000210 *TRACE 004737 
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OTS*I 001000 1 


317722 = 4073, 


words 


(RWrlrLCL.RELrCDN) 






*tOTSI 


001000 


*CyTIF 


001000 


*cyTic 


001014 




«CyTID 


001014 


CCI* 


001026 


cni« 


001026 




*IC 


00 102 A 


*iri 


001026 


CFI* 


001042 




*IR 


001042 


EXP 


001126 


ADFSIS 


001466 




ADF$PS 


001474 


SUF*PS 


001500 


SUF*MS 


001504 




ftDFJMS 


001516 


SIJF*IS 


001526 


*ADriF 


001534 




*SUBF 


001550 


SLJF*SS 


001562 


$SBR 


001562 




AriFJSS 


001566 


*ADR 


001566 


ADD* 


001602 




DIFJPS 


002226 


rUFJMB 


002232 


DIF*IS 


002242 




*DiyF 


002250 


riIF$SS 


002262 


*DyR 


002262 




MUF$PS 


002550 


MUF*MS 


002554 


MUF*IS 


002564 




$MULF 


002572 


MUF*SS 


002604 


*MLR 


002604 




$OTI 


003142 


**OTI 


003144 


SSETQP 


003354 




*$SET 


005026 


SORT 


005322 


STK*L 


005516 




STK*I 


005522 


STK*F 


005526 


IGR* 


005536 




ANn$ 


005542 


EQy* 


005550 


XOR* 


005552 




NMI$1M 


005566 


NMI*1I 


005600 


BLE4 


005610 




BEC!$ 


005612 


BGT* 


005620 


BGE* 


005622 




BRA* 


005624 


BNE* 


005630 


BLT* 


005632 




CAI* 


005642 


CAL* 


005650 


END* 


005700 




ERR* 


005712 


$ENCi 


005724 


*ERR 


005742 




*OPNER 


005764 


*CHKER 


006022 


*IOEXI 


006046 




*EQL 


006114 


EQL* 


006116 


EXIT 


006232 




MOF*SS 


006236 


MOFtMS 


006250 


MOF*PS 


006262 




MOF*SM 


006266 


MOFJSP 


006276 


MOF«MM 


006302 




MOF*MA 


006314 


MOF*MP 


006322 


MOF*PM 


006330 




MOF*PA 


006334 


MOF*PP 


006340 


MOF*RS 


006344 




MDF*RM 


006352 


MOF*RA 


006362 


MOF*RP 


006366 




N6D*S 


006372 


NGF*S 


006372 


NGD*M 


006404 




NGF*M 


006404 


NGD*P 


006420 


NGFiP 


006420 




NGn*A 


006424 


NGF*A 


006424 


Ani*ss 


006430 




ADI*SA 


006434 


ADIiSM 


006440 


ADI*IS 


006444 




ADISIA 


006450 


ADI*IM 


006454 


Ani*MS 


006460 




Ani*MA 


006464 


Ani*MM 


006470 


CMI*SS 


006474 




CMI*SI 


006500 


CMI*SM 


006504 


CMI*IS 


006510 




CMI*II 


006514 


CMI*IM 


006520 


CMI*MS 


006524 




CMI*MI 


006530 


CMI*MM 


006534 


IFU* 


006540 




*IFIJ 


006544 


$*IFU 


006550 


IFU** 


006606 




MOI*RS 


006656 


MOL*RS 


006656 


MOI*RM 


006662 




MOI*RP 


006666 


MOI*RA 


006670 


MQI*SS 


006674 




MOL*SS 


006674 


MOI*SM 


006700 


MOI*SA 


006704 




MOI*IS 


006710 


MQL*IS 


006710 


REL* 


006710 




MDI*IM 


006714 


MOI*IA 


006720 


MOI*MS 


006724 




MOI*MM 


006730 


MOI*MA 


006734 


MOI*OS 


006740 




MOI*OM 


006744 


MOI*OA 


006750 


M0I*1S 


006754 




MOItlM 


006762 


M0I*1A 


006770 


ICI*S 


006776 




ICI*M 


007002 


ICI*P 


007006 


ICI*A 


007010 




DCI*S 


007014 


riCI*M 


007020 


DCI*P 


007024 




DCI*A 


007026 


IDINT 


007032 


INT 


007032 




MOI«IP 


007060 


MOItSP 


007062 


MOI*PP 


007070 


RT-11 LINK V08.00 Load Map 


Saturdaa OS-Jan 


-83 lot 11 Paae 


SYSLIB.SAV T 


itle: .MAIN. 


Identi 


F0RV02 










MOI*MP 


007074 


MOI*PS 


007104 


MOI*PM 


007112 




MOI*PA 


007120 


MQI*OP 


007126 


M0I*1P 


007134 




ISN* 


007144 


*ISNTR 


007150 


LSN$ 


007164 




*LSNTR 


007170 


SUItSS 


007324 


SUItSA 


007330 




SUI*SM 


007334 


SUI*IS 


007340 


SUI*IA 


007344 




SUI*IM 


007350 


SUI*MS 


007354 


SUI*MA 


007360 




SUI*MM 


007364 


MOL*SM 


007370 


MOL*SA 


007374 




MOL*MS 


007400 


MOL*MM 


007410 


MOL$MA 


007414 




MOL*SP 


007420 


MOL*PP 


007426 


MOL*MP 


007432 




MOL*PM 


007442 


MOL*PS 


007450 


MOL*PA 


007454 




MOL*IM 


007462 


MOL*IA 


007470 


MOL*IP 


007476 




LLE* 


007506 


LEQ* 


007510 


LGT* 


007516 




LBE* 


007520 


LNE* 


007530 


LLT* 


007532 




TSL*S 


007536 


TSL*M 


007542 


TSL*I 


007546 




TSL*P 


007554 


MAXO 


007562 


MINO 


007606 




RET*L 


007632 


RET*F 


007636 


RET$I 


007644 




RET* 


007646 


*OTIS 


007702 


**OTIS 


007704 




TvL* 


010024 


*TvL 


010024 


TvF* 


010032 




*TVF 


010032 


TMD* 


010040 


*TI.ID 


010040 




TyQ* 


010046 


*TyQ 


010046 


TMP* 


010054 




*TVP 


010054 


TVI* 


010062 


*TUI 


010062 




SAL*IM 


010216 


SAL*SM 


010220 


SVL*IM 


010224 




SyLtSM 


010226 


SAL*MM 


010234 


SyL*MM 


010240 




SAL4IP 


010244 


SALtSP 


010246 


SVL*IP 


010252 




SyL*SP 


010254 


SAL*MP 


010262 


SVL*MP 


010266 




*CyTFB 


010272 


tCVTFI 


010272 


*CVTCB 


010306 




*cyTci 


010306 


*CVTriB 


010306 


*CyTDI 


010306 




CIC* 


010320 


CID* 


010320 


CLC* 


010320 




CLIi* 


010320 


*DI 


010320 


CIF* 


010330 




CLF* 


010330 


*RI 


010330 


CIL* 


010442 




CLI* 


010446 


*INITI 


010450 


*CLOSE 


010566 




tERRTB 


011344 


$ERRS 


011451 


*FCHNL 


015212 
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OTS$P 
SYS«I 



USERJI 
*CODE 



SYStO 

tDATAP 

OTS*D 

OTS*S 

SYSJS 

$rJATA 
USER*D 



020722 
02077A 



021242 
021242 



000054 
000244 



000000 
001316 



OTS*0 022560 001036 = 



023616 
023616 
023724 

023732 

023734 

023740 
024476 
024476 



000000 
000106 
000006 

000002 

000004 

000536 
000000 
000000 



*FIO 

$PL]TBL 

«EaF2 

*STPS 

F00$ 

*yRINT 
- 22 * 
= i32. 

LEN 
= 0. 
= 359. 

**OTSC 
271. 

*$OTSO 
= 0. 
= 35. 
= 3. 

NHCLN* 
= 1. 

*AOTS 

*SYSLE 
= 175. 
= 0. 
= 0. 



016054 

017532 

020142 

020342 

020354 

020562 

word<5 

words 

020776 

wordsi 

wordis 

021242 

words 

022560 

words 

words 

words 

023730 

words 

023732 

words 

023734 

words 

words 

words 



$*FIO 
$GETBL 
SAMRG* 
STP!t 
!t£XIT 
«IiUMPL 
(RWrTuGBL 
( RU > I , LCI. 

REPEAT 
(RUiIpLCL. 
(RU rip LCI- 
FUN 
( RW > 1 , LCL 

*QPEN 
( RU T I r LCL 
(RW»D»LCL 
( RU r D > LCL 



*PUTRE 

$EOFIL 

THRD* 

$STP 

JUAIT 



016060 

017742 

020162 

020350 

020374 

020574 

rREL.OVR) 

pREL.CON) 

021014 SCDPY 

tRELpCON) 

iRELrCQN) 

022120 PUTSTP 

RELrCON) 
022560 
pRELiCDN) 
rREL.CON) 
rRELfCON) 



<RW>D,LCLtREL>CON) 

<RWyi:i,LCLrRELrCQN) 

*LOCK 023736 $CRASH 
(RW>n.LCL»RELiCON) 
<RUpD.LCL»REL»CON) 
(RU>DieBL»REL>OyR) 



017224 
020126 
020340 
020350 
020520 



021146 



022266 



023737 



RT-11 LINK 
SYSLIB.SAV 



V08.00 

Title: 



Load Map Saturday 08-Jan-83 10;il PaSe 3 
.MAIN. Ident: FDRi.'02 



Transfer address = 021242 r Hiah limit " 024474 



5278. 



RT-11 LINK y08.00 Load Map Saturday 08-Jan-83 10! 16 Paae 1 
TEST .SAV Title; .MAIN. Ident! 



Section Addr 



Size 



Global Value Global Value Global Value 



AES. 000000 001000 = 256. words <RUi I jGBLj ABSiOVR) 
001000 000626 = 203. words (RWf I f LCLrREL.CDN) 

PROG 001000 SUBONE 001372 SUBTUO 001434 



Transfer address 



001000, Hiah limit = 001624 



words 



The second line has the name and file type of the load module 
created. Next, the absolute section and each named and un- 
named section are listed under the SECTION column. To the 
right are abbreviated codes designating whether the section 
contains Instructions or Data, is ReadAVrite or Read Only, is a 
Local or Global section, is Relocatable or Absolute, is Concat- 
enated or Overlaid. Below this falls a listing of all the global 
symbols (GLOBAL) and their values (VALUE). Finally, at the 
end of the map is the transfer address where the program actu- 
ally starts when executed, followed by the high limit — the 
total number of bytes used by all the individual program sec- 
tions. 

Look first at the MACRO-11 load map. The default absolute 
section starts at absolute location 0; its size is 1000 bytes. Thus, 
it extends from absolute memory location through absolute 
memory location 777. The unnamed program section (there 
were no named program sections in this program) starts at ab- 
solute 1000; its size is 372 bytes. Thus it extends from absolute 
location 1000 to absolute location 1370. The high limit of this 
program (total bytes) is therefore 1370. Since this program is 
not linked to any other object modules, there are no global sym- 
bols and the rest of the map is blank. 

Look now at the FORTRAN IV load map, remembering that it 
reflects the appropriate expansions into machine language code 
provided by the FORTRAN IV compiler. Again, the absolute 
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section extends from absolute through absolute 777. Globals 
listed in the absolute section show the global variable names 
that the program uses as constants throughout the program. 

The unnamed relocatable program section begins at absolute 
location 1000. Some of the named relocatable sections that are 
declared are OTS$P, SYS$I, and $CODE. Global symbols and 
their respective addresses appear to the right of all sections. 
The total number of bytes used is 24474, or 5278(decimal) 
words. 

The third load map is for the program illustrated in Figure 
12-2. First, the map shows the absolute program section, la- 
beled .ABS. It extends from location through location 777. 
Next, the map shows the unnamed program section, which be- 
gins at location 1000 and is 1624 bytes long. This program sec- 
tion consists of a main program, called PROG, and the sub- 
routines SUBONE and SUBTWO that were linked with PROG. 
Look again at Figure 12-2 to see how these routines fit into 
memory. The transfer, or starting, address is 1000, and the 
total number of bytes the program occupies is 1624, or 458(dec- 
imal) words. 

Load maps are most helpful when used in debugging to locate 
and correct assembly language programming errors. Load maps 
are not generally obtained or used for FORTRAN IV programs, 
except to determine program size. In Chapter 14 you will see 
how a load map is used to debug the one remaining error in the 
MACRO-11 demonstration program. 



LINK 

Link individual object modules together to form a complete 
program and to produce a load module. 

LINK/MAP 

Link individual object modules, and produce a load map 
showing all address assignments made during linking. 

NOTE 

FORTRAN IV users who followed the special instruc- 
tions in Appendix B to load the language or LINK volume 
should now stop the system, unload that volume, load 
the main system volume, and rebootstrap the system 
before going on to Chapter 1 3. 



SUMMARY: 

COMMANDS 

FOR LINKING 

PROGRAMS 



RT-ll System Utilities Manual (AA-M239A-TC). Maynard, Mass.: Digital 
Equipment Corporation, 1983. 

A guide to the use of the RT-ll system utilities. 



REFERENCE 
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CHAPTER 13 
CONSTRUCTING LIBRARY FILES 



A library is a specially constructed file consisting of one or 
more programming routines. Generally, these routines provide 
services that you are apt to need repeatedly, or services that are 
related and so have been gathered together for ease in use and 
storage. You use the routines in a library by joining the library 
file with your source program. Usually this occurs at link-time: 
but in the case of assembly language programs, it may also 
occur at assembly-time. 

The RT-11 operating system provides several library files; 
SYSLIB and VTLIB for example. These libraries supply the 
monitor services, input and output routines, conversion 
routines, and other programming services that user programs 
may need. You can create other library files yourself. Thus you 
can construct libraries that contain routines specific to your 
programming needs or to the combined needs of those using 
your RT-11 system. 



There are two kinds of library files 
ject libraries. 



macro libraries and ob- 



KINDS OF 
LIBRARY FILES 



Macro libraries, such as SYSMAC.SML, are used by 
MACRO-11 source programs at assembly-time and consist en- 
tirely of macros. A macro is described in Chapter 11 as a recur- 
ring sequence of coding instructions, which, when defined in a 
.MACRO statement, can then be called and used anywhere in 
your program. A macro library is merely several macro defini- 
tions gathered together into a single file. To use the macros in a 
macro library, you simply name those macros you plan to use in 
a .MCALL statement. When the assembler encounters the 
.MCALL statement during processing, it searches the appropri- 
ate macro library (SYSMAC.SML is default) for the definitions. 
It takes the definitions from the library and inserts them in a 
special table called the macro symbol table where they become 
available for use during assembly. 



Macro Libraries 



Object libraries, such as SYSLIB, are used by assembled 
MACRO-11 source programs and/or by compiled FORTRAN IV 
source programs at link-time. These libraries consist of object 
modules that contain global routines; such routines have been 
defined with global entry points and then named as global sym- 
bols in the source program. During the link operation, the 
linker searches the object libraries to determine if they provide 



Object Libraries 
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definitions for any undefined globals. If the linker finds defini- 
tions, it takes those object modules containing the definition 
from the library and includes them in the link. 

A special table, called the global symbol table, lists each global 
in a given object library. You can print this list on the terminal 
or the line printer and thus keep track of an object library's 
current contents. 



CREATING AND 
MAINTAINING 
A LIBRARY FILE 



You create a library file by combining several macro routines, 
or several object modules, into a single larger file using the 
monitor LIBRARY command. 

To build a macro library, first use the editor to create an ASCII 
text file that contains all the macro definitions. Then process 
this file using the LIBRARY command in combination with its 
/MACRO option. To update a macro library (that is, to add or 
delete macro definitions), simply edit the ASCII text file and 
then reprocess the file with the LIBRARY command. 

To build an object library, use the editor to create an ASCII text 
file. The file contains the routines and functions written as 
complete program segments in either the MACRO-11 assembly 
language or the FORTRAN IV programming language. Then 
process the file, producing an object module. Next, use the LI- 
BRARY command in combination with its /CREATE option. 
Once the library file is created, update it (add and delete 
routines) by means of various other options to the LIBRARY 
command. 

In the following exercises, you create an object library that con- 
tains three input object modules. The routines in two of these 
modules can be used by both MACRO-11 and FORTRAN IV 
programs; the routine in the third module can be used only by 
FORTRAN IV programs. 

To build the library file, first use the editor to create the three 
ASCII text files. Then convert the ASCII text files to object 
format. Finally, process the object files with the LIBRARY com- 
mand. Once you create the library files, use LIBRARY com- 
mand operations and options to add and delete modules and 
globals and to obtain a listing of the library file contents. 



Creating Object 
Library Input Files 



The first step in building an object library is to prepare the 
source code of the routines and functions that you choose to 
include in the library. Use the editor to create the following 
three text files, calling them FIRST.MAC, SECOND.MAC, and 
THIRD.FOR, respectively. FORTRAN IV users should create 
all three files; MACRO-11 users (who do not use FORTRAN 
IV) should create only the first two files. 
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FIRST.MAC 










.TITLE 


COMB 








♦MCALL 


.PRINT 






5 


I=LEN(A) 
.GLOBL 


LEN 






LEN: 


TST 


(R5) + 


iSKIP 


« OF ARCS 




MOM 


@R5 tRO 


iGET 


STRING POINTER 


1$: 


TSTB 


(R0) + 


iFIND 


END OF STRING 




BNE 


1* 


iLOOP 


UNTIL NULL BYTE 




DEC 


RO 


iBACK 


UP 




SUB 


@R5»R0 


iCALC 


# OF CHARS IN STRING 




RTS 


PC 






5 


CALL 


PRINT( ISTRNG) 






.GLOBL 


PRINT 






PRINT: 


MOV 


2(R5) ,R0 




iADDR OF ISTRNG 




.PRINT 




i. PR I NT 




RTS 


PC 


;AND RETURN 




.END 









SECOND.MAC 



; I=ITTOUR(ICHAR) 








i 1=0 


CHARACTER 


HAS 


BEEN OUTPUT 


! =1 


RING BUFFER 


IS 


FULL 


.MCALL 


.TTOUTR 








.GLOBL 


ITTOUR 








ITTOURiMOVB 


@2(R5) .RO 






iGET CHARACTER 


.TTOUTR 








i .TTOUTR 


BIC 


ROtRO 






iCLEAR ERROR FLAG 


ADC 


RO 








RTS 


PC 






i RETURN 


.END 











THIRD.FOR 

C CALL PUTSTR(LUN»AREA .CO 

SUBROUTINE PUTSTR ( LUN . AREA ,CC ) 

LOGICAL*! AREA(Z50) ,CC 

IF(CC) GOTO 1 

WRITE (LUN .33) (AREA(I) ,1 = 1 .LENCAREA) ) 

RETURN 
1 WRITE (LUN.33)CC,(AREA(I) ,1 = 1 ,LEN(AREA) ) 
33 F0RMAT(250A1 ) 

END 



The routines in these files are representative of the kinds of 
services generally provided in a library file. They are, in fact, 
taken from the RT-11 system subroutine library, SYSLIB. 
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FIRST.MAC contains two global routines, LEN and PRINT. 
The LEN routine returns the number of characters in a string. 
PRINT outputs an ASCII string terminated with a zero byte to 
the terminal (it is the FORTRAN IV equivalent of the system 
macro .PRINT, used in the demonstration program in Chapter 
11). SECOND.MAC contains one global routine, ITTOUR, 
which transfers a character to the console terminal. 
THIRD .FOR also contains one global routine, PUTSTR. This 
routine can be used only by FORTRAN IV programs and writes 
a variable-length character string on a specified FORTRAN IV 
logical unit (see GRAPH example). 

Once you create these text files, the next step is to convert them 
from ASCII format to object format. Assemble or compile the 
text files as appropriate, first assembling FIRST.MAC and ob- 
taining an object module (a listing is not necessary). FORTRAN 
IV users who are not familiar with the assembly process simply 
type the MACRO commands as shown. 

Long Command Format 

.MACRO® 
Files? FIRST® 

Short Command Format 

.MACRO FIRST® 

The command creates an object module called FIRST.OBJ on 
the system volume. If errors occur, the assembler prints a mes- 
sage on the terminal, indicating the number of errors encoun- 
tered during assembly. No errors should occur. 

In the same way, assemble SECOND.MAC. Again, no errors 
should occur. 

Long Command Format 

.MACRO® 
Files? SECOND® 

Short Command Format 

.MACRO SECOMD® 

If any errors occur during the assembly operations, you have 
typed the source files incorrectly. Find and correct the typing 
errors, and reassemble. 

If you are a FORTRAN IV user, continue by compiling 
THIRD.FOR. 
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NOTE 

If in Chapter 9 you needed to load the special 
FORTRAN/BASIC language volume, you must again 
load that volume before you can compile THIRD. FOR. 
Read Appendix B, Substituting Volumes During Opera- 
tions, before continuing. 

Long Command Format 

.FORTRAN® 
Files? THIRD®) 
PUTSTR 



Short Command Format 



.FORTRAN 
PUTSTR 



THIRD®) 



Notice that the compiler prints the name of the global 
(PUTSTR) generated. If any errors occur during the compile 
operation, you have typed the source file incorrectly. Find and 
correct the typing errrors, and recompile. 

Once you have produced the object modules, you are ready to 
build the object library file. 



Use the LIBRARY command in combination with its /CREATE 
option to construct a library file. You must indicate in the com- 
mand the name of the library file and the names of the input 
object modules. Call the library file LIBRA and specify as input 
the two object modules, FIRST and SECOND. The LIBRARY 
command assumes that the input modules have the .OBJ file 
type (unless you indicate otherwise) and automatically assigns 
.OBJ to the library file. 

Long Command Format 

.LIBRARY/CREATE® 

Library? LIBRA® 

Files ? FIRST (SECOND® 



Building the 
Object Library 



LIBRARY/ 
CREATE 



Short Command Format 

.LIBRARY/CREATE LIBRA FIRST tSECOND® 

Once the CREATE operation is complete, obtain a listing of the 
library file's contents, using the LIBRARY command with its 
LIST operation. The line printer is the assumed output device 
for the list file, although you may indicate a different output 
device by adding the two-letter device mnemonic to the LIST 
option that follows. 
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LIBRARY/LIST 



Long Command Format 

(Line printer) 

.LIBRARY/LIST® 
Library? LIBRA® 

Short Command Format 

(Line printer) 

.LIBRARY/LIST LIBRA® 



(Terminal) 



.LIBRARY/LISTsTTs 
Library? LIBRA® 



(Terminal) 

.LIBRARY/LISTsTTs LIBRA® 



The listing produced shows the library file's current contents. 
This library has three entry points: LEN and PRINT in the first 
module, and ITTOUR in the second module. 



RT-ll LIBRARIAN V05.00 SAT 
DKsLIBRA.OBJ SAT 



8-JAN-83 ll:03s29 
S-JAN-83 10359543 



MODULE 



GLOBALS 

LEN 
ITTOUR 



GLOBALS 
PRINT 



GLOBALS 



Updating the 
Object Library 



LIBRARY/ 
INSERT 



Once you have created an object library, you use various LI- 
BRARY command operations to update and maintain it by 
adding and deleting modules and globals. 

If you created the THIRD. OBJ object module, you can add it to 
the library file using the INSERT option. If you did not create 
this module, read through this section anyway; the command 
steps apply to any object module you wish to insert. 

Long Command Format 

.LIBRARY/INSERT® 
Library? LIBRA® 
Files ? THIRD® 

Short Command Format 

.LIBRARY/INSERT LIBRA THIRD® 

This operation inserts the object module contained in the file 
THIRD.OBJ, including all its globals, into the library file 
LIBRA. Obtain a listing of the library contents, using the LIST 
option, to verify that the new globals have been added. The 
listing should look like this: 

RT-ll LIBRARIAN M05,00 SAT 8-JAN-83 11 :05s 1 
DKsLIBRA.OBJ SAT 8-JAN-83 lls04sZl 



MODULE 



GLOBALS 

LEN 

ITTOUR 

PUTSTR 



GLOBALS 
PRINT 



GLOBALS 
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This listing shows the complete library file containing the glo- 
bals from all three modules. 

You can remove individual globals by using the REMOVE op- 
tion. For example, to remove the global ITTOUR, type: 

Long Command Format 

. LIBRARY/REMOVE® 
Library? LIBRf 
Global? ITTOUF 
Global?(Rg| 

Short Command Format 

• LIBRARY/REMOVE LIBRA® 
Global? ITTOUR® 
Global?® 

The library file's contents now look like this: 

RT-ll LIBRARIAN U05,00 SAT B-JAN-83 11:10:22 
DK:LIBRA,DBJ SAT B-JAN-83 11:10:05 



MODULE 



GLOBALS 

LEN 
PUTSTR 



GLOBALS 
PRINT 



GLOBALS 



LIBRARY/ 
REMOVE 



These are some of the library maintenance operations that you 
can perform by using the LIBRARY command. Other library 
operations are available and are explained in the RT-ll 
System Utilities Manual. 



LIBRARY/MACRO 

Create a macro library. 

LIBRARY/CREATE 

Create an object library. 

LIBRARY/INSERT 

Insert object modules into the object library. 

LIBRARY/LIST[:filespec] 

List the current contents of an object library on the line 
printer; [:filespec] is an optional output file and/or device. 

LIBRARY/REMOVE 

Remove globals from the object library. 



SUMMARY: 

COMMANDS FOR 

MAINTAINING 

LIBRARY FILES 



Since all the object modules used in this chapter already exist 
as modules within the provided system library SYSLIB, there is 
no need to save them or the LIBRA library file. You can delete 
these object modules and their source files from your system 



FILE MAINTENANCE 
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volume by using the DELETE command as follows (exclude 
THIRD.* from the command line if you did not create this file): 

Long Command Format 

• DELETE/NOQUERYESI 

Files? FIRST.#»SECOND.*,THIRD.« »LIBRA . OB J® 

Short Command Format 

.DELETE/NOOUERY FIRST .* »SECOND ,# ,TH I RD .* .LIBRA , OBJ® 

FORTRAN IV users who performed the special instructions 
given in Appendix B should also delete the THIRD files from 
the storage volume. 

Long Command Format 

.DELETE/NOQUERY® 
Files? UOLsTHIRD.*® 

Short Command Format 

.DELETE/NOQUERY UOL : THIRD . *(rS) 



REFERENCE 



RT-ll System Utilities Manual (AA-M239A-TC). Maynard, Mass.: Digital 
Equipment Corporation, 1983. 

A guide to the use of the RT-ll system utilities. 
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CHAPTER 14 
DEBUGGING A USER PROGRAM 



Debugging is the process of finding and fixing the programming 
errors that almost every user program initially contains. From 
your experience in Chapters 9, 10, and 11, you already know 
about some of the kinds of programming errors that can pre- 
vent a program from working properly when you run it on the 
system. 

Frequently, debugging a program requires more time and per- 
sistence than writing the program code requires. Therefore, you 
should anticipate the debugging process throughout the entire 
program development cycle. That is, you should follow some 
common programming practices that help you first to make as 
few programming errors as possible. When errors become ap- 
parent during the various phases of development, correct them 
immediately. Test the validity of any algorithms used within 
your program. Finally, even though the program appears to be 
working properly, check it thoroughly with test data. 



You can take several steps to decrease the likelihood of intro- 
ducing errors into your program and to make debugging easier. 

First, always use a high-level language if one will suit your 
programming needs. High-level language programs tend to use 
fewer statements. English-like words and phrases in the lan- 
guage statements make the program logic easier to follow. 

Design the program. The technique of flowcharting the pro- 
gram and then correlating it with the program coding simpli- 
fies tracking the program logic and module interrelationships. 

Use modular programming. Create the program as a series of 
smaller, self-contained subprograms. Debug the program in 
parts. 

For frequently used functions, maximize the use of subroutines, 
subprograms, and — in the case of assembly language pro- 
grams — macros. These help to structure the program and 
make it easier to alter or to add features that may be required 
in the future. 

Make use of any software provided by the system, such as li- 
brary routines and functions. System software has already been 
debugged and can save you the trouble of re-creating the ser- 
vices. 

Make the general flow of a program proceed down the page. 
Avoid nonstructured branching and convoluted logic, as these 



AVOIDING 

PROGRAMMIMG 

ERRORS 
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tend to produce programs that are difficult to debug. Finally, 
use comments liberally throughout the program to show what 
individual statements or groups of statements do. Use spaces 
and tabs in the program code to make it easier to read. 

Following these preventative steps eliminates many common 
programming errors and helps to create a programming style. 
However, even the most careful programmer may overlook a 
small detail: a typing error during program creation, an unde- 
fined label in the code, or some other programming bug. When 
something is overlooked, debugging becomes necessary. 



WHEN 

PROGRAMMING 
ERRORS OCCUR 



There are three general types of programming errors 
clerical, and logical. 



syntax. 



Syntax errors are errors in the physical coding, such as omit- 
ting necessary portions of the statement (delimiters for ex- 
ample), reversing the order of information within the state- 
ment, or misspelling keywords or instructions. 

Clerical errors are non-syntax errors in the physical coding, 
such as mistyped letters or digits in data. Clerical errors may 
result in valid statements that do not reflect correct program- 
ming logic. 

Logical errors are errors made in program development. 

The translating program (compiler/assembler/interpreter) gen- 
erally catches syntax errors and flags them as such in the pro- 
gram listing or on the terminal. On the other hand, you must 
locate clerical and logical errors by reexamining the program 
code and logic, using one or more debugging techniques. 

Some debugging techniques involve insertion of special debug- 
ging code within the program. For example, one way to locate 
logical errors is to write out intermediate results of a program. 
You can insert WRITE or PRINT statements at strategic points 
in the program logic to show the intermediate state of values 
being calculated. When debugging is complete, you can remove 
these statements or change them to comments. 

You may also find it useful to write a special debugging subrou- 
tine that writes out values, particularly if the same variables 
must be examined in several places or many times. 

Another method for finding logic errors — unit testing — is to 
break the program into smaller parts and test each part sepa- 
rately with artificial data. After you test all parts individually, 
you can test routine and module linkage — system testing — to 
see that all related code fits together properly. 

Check the program with test data. A standard method for 
checking out modules is to write a test program that calls the 



14-2 



Debugging a User Program 



program with possible options. The test should cause the pro- 
gram to execute all steps in all algorithms. Check programs 
first with representative data, then with improper data (data 
that is not in the correct range or size). You should also do 
volume testing to see that the program works successfiilly with 
a representative amount of data. 

Each programming language has special debugging aids for ex- 
amining immediate states. For example, BASIC-11 has a 
STOP statement that you can insert at strategic points in the 
program. When the program arrives at a STOP statement, it 
pauses so that you can use BASIC-11's immediate mode to ex- 
amine variables, values, and so on. Use an immediate mode GO 
TO statement pointing to the appropriate line number to con- 
tinue execution. 

FORTRAN IV has a special DEBUG statement indicator, a D 
in the first column of a statement line. Operations in state- 
ments marked with a D can perform useful debugging func- 
tions, such as printing intermediate results. You can treat such 
statements as source text (and thus execute them) or as com- 
ments (and thus ignore them), depending on whether you use a 
special compiler command option. In addition, FORTRAN IV 
has a traceback feature that locates the actual program unit 
and line number of a run-time error. If the program unit is a 
subroutine or function subprogram, the error handler traces 
back to the calling program unit and displays the name of that 
program unit and the line number where the call occurred. This 
process continues until the calling sequence has been traced 
back to a specific line number in the main program unit. Fi- 
nally, FORTRAN IV has an optional interactive debugger 
called FDT (FORTRAN DEBUGGING TECHNIQUE) that can 
be linked with a user program. 

For MACRO-11 users, RT-11 provides a special on-line debug- 
ging tool called ODT (On-line Debugging Technique). This is 
provided as part of the RT-11 operating system and is an object 
program on your system volume. It is used exclusively for de- 
bugging assembled MACRO-11 programs. 

The use of ODT is described next for MACRO-11 users and for 
those FORTRAN IV users who will be combining MACRO-11 
and FORTRAN IV program code. Other users can continue to 
x^iiapter 15, or go back and perform one of the other language 
demonstrations. ~ ' 
Preface. 



Refer to the reading path outlined in the 



ODT is an interactive debugging tool that allows you to mon- 
itor program execution from the console terminal. ODT is pro- 
vided as the object module ODT.OBJ on your system volume. 
To use it, you link ODT.OBJ with the assembled MACRO-11 



USING THE ON-LINE 
DEBUGGING 
TECHNIQUE 
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Short Command Format 

(Line printer) (Terminal) 

, LINK/MAP/DEBUG yOL:BUMei .LINK/MAP : TT : /DEBUG UOLrSUM® 

RT-11 LINK UOB.OO Load Map Saturday 08-Jan-83 lOiOG PaSe 1 
SUM .SAU Title; ODT Ident: yOS.OO 

Section Addr Size Global Value Global Value Global Value 

. ABS. 000000 001000 = 25B. words ( RW 1 1 iGBL . ABS .QMR ) 

001000 000372 = 125. words ( RW . I .LCL iREL .CON ) 

$QDT* 001372 00B152 = 158S. words ( RW . I iLCL .REL .CON ) 

O.ODT 001B24 

Transfer address = 001B2a. Hish limit = 007542 = 1SB9. words 

Look at the load map, and note that ODT starts at address 
1372. The two modules together, ODT and SUM, reside in 
memory up to location 7542, the high limit. Look at the symbol 
table listing for the MACRO-11 program. This shows that the 
program is 372(octal) bytes long and starts at location 1000. 

To load and start execution of the load module, use the monitor 
RUN command. The RUN command brings the entire load 
module, called SUM.SAV, into the absolute (physical) memory 
locations shown in the load map and begins execution automat- 
ically at the starting, or transfer, address of the first module in 
memory, which is ODT. Type: 

Long and Short Command Format 

.RUN SUh 



ODT yo5.oo 



ODT prints an identifying message on the terminal and an as- 
terisk indicating that you are in ODT command mode and can 
enter an ODT command. You are now using ODT to control the 
execution of your program.^ ODT commands let you execute the 
entire program or just portions of it, examine individual loca- 
tions, examine the contents of the PDP-11 general registers, 
and change the contents of any locations in your program you 
wish. If you make a mistake while you are tjrping any com- 
mands, type the DELETE key; ODT responds with a question 
mark (?) and an asterisk (*), allowing you to enter another 
command. 



^Be sure to read the chapter on ODT in the RT-11 System Utilities Manual 
before you use ODT with any of your own programs. You must observe certain 
precautions when you write your program and when you load it with ODT. 
For example, you should make sure that ODT is not loaded into memory 
locations used by your program. Follow the precautions described in the 
RT-11 System Utilities Manual. 
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Look at locations 6 through 16 in the assembly listing. With 
ODT, you can examine these locations in memory as follows (all 
ODT commands use octal numbers, as does the assembly 
listing): 

*100B/012705G) 
001010 /OOOIOB© 
001012 /012700(kE) 
001014 7 000107© 
0010 IB /O 12701® 

By typing a location address and a slash, you open that location 
for examination and possible modification. A line feed closes 
that location and opens the next sequential location for exami- 
nation. A carriage return simply closes the currently open loca- 
tion. 

Note that since the MACRO-11 program was linked to begin at 
address 1000, you must add the constant 1000 to each address 
shown in the assembly listing to obtain the actual address used 
during loading. ODT can do this for you by using special in- 
ternal locations called relocation registers. Each register can be 
set to a relocation constant. Thus, if you have linked several 
modules together, you can set various relocation registers to the 
corresponding relocation constants of the individual modules. 
You then indicate in your command which register to use, and 
ODT automatically adds the constant in that register to the 
address specified in your command. For example, set relocation 
register to 1000: 

#1000 5 OR 

Now, to examine locations through 10 in the assembly listing, 
type: 

«0 »0/ 012700© 
0t000002 /0012l\'M 
0(000004 /104351© 
OtOOOOOB /012705G) 
OfOOOOlO /OOO1O0SI 

In your commands, indicate the number of the relocation reg- 
ister (followed by a comma), since generally you will have more 
than one register set at a time. 

Execute the MACRO-11 program now, using the ODT ;G com- 
mand, indicating in the command where you wish execution to 
start. In this case, the program's start (transfer) address is 
1000, so type: 

THE yflLUE OF E IS: 

2. 5/B0e/B0B237. 23013 14. 05525/1304^0275535025. 71 4777373527447^5^05502. Saa 
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As you discovered in Chapter 11, these program results are 
incorrect. Note that a period has printed, indicating that you 
are back in monitor command mode. This particular 
MACRO-11 program returns to the monitor after execution. 
Therefore, to continue using ODT, you must RUN the load 
module again: 

Long and Short Command Format 

.RUN SUM® 
ODT U05,00 



Changes that you make to a program while using ODT, and 
ODT register assignments that you make, are temporary. Thus, 
when you restart ODT, you must reenter any commands, such 
as relocation register commands, that you want to remain in 
effect. Reset relocation register 0: 

*iooo;oR 

To help you find programming errors, ODT provides a break- 
point feature. Setting one or more breakpoints in a program 
causes program control to pause at those locations during exe- 
cution. When control pauses, ODT prints a short message on 
the terminal, informing you that a breakpoint has occurred and 
showing the location at which execution has stopped. This 
pause returns control to ODT and gives you the opportunity to 
examine and possibly modify variables or data. Breakpoints are 
numbered from to 7, so that you can have a total of eight 
breakpoints set at various instructions in the program at one 
time. 

For example, set breakpoint at location 22 (line 16 in the 
assembly listing) and breakpoint 1 at location 40 (line 23): 

*0 »22;0B 
*0 j40ilB 

Now when you run the program, control pauses first at location 
22. Since the breakpoint was set at the instruction at location 
22, that instruction has not yet been executed, but all preceding 
instructions have: 



•»OtOiG 

TBOiO (000022 



Note the message that ODT prints when execution reaches the 
breakpoint. Normally when execution encounters a breakpoint, 
only the breakpoint number and location are printed on the 
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terminal. In this case, the letter T precedes the breakpoint mes- 
sage. This happens because of the way the ODT program uses 
the console terminal. The assembly instruction .PRINT at line 
12 of the assembly listing requests the monitor to print a pro- 
gram message at the same time that ODT needs to print the 
breakpoint message. ODT, however, has higher priority. By the 
time the .PRINT request starts to print the program message, 
execution reaches the breakpoint and gives control to ODT. The 
.PRINT request has time to print only one character of its mes- 
sage before ODT takes over and prints the breakpoint message. 
When the program regains control, its message will continue 
printing from the second character. 

Program control has paused at location 22 in the MACRO-11 
program. Look in the assembly listing at the instructions that 
occur there. The instruction at location 16 (line 15) stores the 
address of the digit vector (at label A) in register 1 (Rl). Exam- 
ine the contents of register 1 to discover what this address is; 
then open the address and examine its contents and the con- 
tents of several addresses following it by using two new ODT 
commands, $ and @: 

*$1/001124 @ 
0(000124 /OOOOOl© 
0»00012B /OOOOOl© 
0(000130 / 000001© 
0(000132 /OOOOOKaD 

The $ command opens for examination the contents of one of 
the general PDP-11 registers through 7. The @ command 
uses the contents of the currently open location as an address 
and opens that location for examination. Notice that the digit 
vector A, which begins at location 124, has been initialized to 
the value 1, the precise value indicated by the comments at line 
48 of the program listing. 

If you were to continue program execution now, the branch in- 
struction at line 22 of the assembly listing would cause pro- 
gram control to loop back to the instruction at line 16 where 
breakpoint is set, again causing execution to pause. Since you 
wanted to continue to the next breakpoint (set at location 40), 
you must first cancel the breakpoint at location 22. To do this, 
type: 

*;oB 

This removes the breakpoint at location 22. The number (in 
this case 0) indicates which breakpoint is to be removed. Now 
continue program execution using the ;P command (proceed 
from breakpoint). Execution progresses through the loop and 
continues until it reaches the breakpoint set at location 40: 
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HBl iO t000040 



(Note that the monitor has time to print the second character, 
and perhaps additional characters, of the program message be- 
fore ODT gains control.) Now examine the contents of several of 
the program vector locations beginning at location 124: 

»0 » 124/000012© 
0»00012B / 00001 20 
0>000130 /000012© 
0.000132 / 0000 12® 

The instructions prior to the breakpoint at location 40 consti- 
tute a multiplication routine. This routine multiplies the vector 
contents by 10 (12 octal), as you have just verified. 

You can see how the breakpoint feature is a very useful debug- 
ging aid. It allows you to execute selected portions of a program 
and verify that data and variables are being used correctly 
during execution. You can use the breakpoint feature to locate 
the error that is in this program. 

First, clear all previously set breakpoints (in this case, there is 
only the one at location 40) by typing the ;B command with no 
argument. 

#;b 

Now set a breakpoint at location 110 (line 41 of the assembly 
listing). You want to verify the data that is being passed to the 
monitor in register in the ADD instruction in line 40. 

*0 .llOiOB 

*;p 

EBOiO .000110 

Now examine the contents of register 0. 

*$0/0000B5 \0G5 =5® 

At this point in execution, register contains 000065. The 
backslash (\) command prints the low-order byte of the opened 

lni/^a"finiT» r\ir\ r\\c^ f\r\tr\ cif\\r\ 4- /^-w**-*-* ■!■*-» <-»! r^-nA nlnn »»«.• — — .X~ J-T- * _ x _ 

j-vrx^Muxv/xx \jxx uxxv/ V/V/xxo\/xO u<c;x 1.XXXXJ.CIX ClllU. CllOU CUllVdta tllXb LO a.11 

ASCII character (if it is a valid ASCII code) and prints the 
character. In this case, the number 5 prints. If you look back at 
the program results printed earlier in this chapter, you can see 
that 5 is the first digit of the tabulated result (following the 
message THE VALUE OF E IS 2). If you are experienced in 
mathematics, you know this result is incorrect because the ap- 
proximate value of E is 2.718. And you now also know that the 
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program error is not in the interface to the monitor service used 
to print the result (.TTYOUT), but that it occurs somewhere 
before location 110. So the next step in debugging this program 
is to set a breakpoint at some earlier point in the program logic 
and to rerun the program. You must restart ODT to do this. 
Return to monitor mode by typing CTRL/C. The remainder of 
the program message prints on the terminal; then the monitor 
period appears, indicating that you are in monitor mode. 

* ictrl;c) 

VALUE OF E IS: 

2. 



Restart ODT and reset relocation register 0. 

,RUN SUM® 



) ODT M05.00 

■ *iooo;oR 



Set a breakpoint at location 76 (line 37 in the assembly listing), 
and start program execution at its beginning. 



#0 t7B!0B 

»o lO ;g 

TBOiO t00007B 



Again, examine register to verify its contents. 

#$0/000033® 

By following the program logic in the assembly listing, you 
know that the value in register should at this point be 
33(octal) (2.7, previously multiplied by 10, = 27[decimal] = 
33[octal]). So the value in register is correct. From this, you 
can deduce that the error must occur somewhere between loca- 
tions 76 and 110. The proper step now is to check the assembly 
listing, where you find the error at line 40. The decimal point 
that should follow the 10, identifying it as a decimal 10, is 
missing. Therefore the program treats the 10 as an octal 10, or 
8(decimal), making each digit in the result off by an additive 
factor of 2. The data in location 106, then, should be 72, not 70. 
Since this data has not yet been used, you can change it now 
with ODT and continue program execution; if it had been used, 
you would need to restart ODT and then change the data. To 
change the contents of a location, simply open the location, type 
in the new contents, and close the location, using a carriage 
return. 

«0 ilOB/ 000070 72® 
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Now eliminate all breakpoints. 



#iB 



Continue program execution; the correct results should print. 

*iP 

THE VALUE OF E IS: 

2.71BZBlBZBa590452353B02B747135ZBG2a977572a70B3B9995957a9GB9B7G27724076B 



SUMMARY: 
COMMANDS FOR 
DEBUGGING 
PROGRAMS 



To Start ODT 

LINK/DEBUG 

Link the assembled program (the program to be debugged) 
with the ODT object module. 



To Use ODT^ 

m 

Close the currently open location and open the next sequen- 
tial location for examination and possible modification. 

m 

Close the currently open location. 

addr/ 

Open the location indicated (addr) for examination and pos- 
sible modification. 

addr;G 

Begin program execution at the indicated address (addr). 

;P 

Continue program execution from a previous breakpoint. 

addr;nB 

Set one of the eight available breakpoints (n) at the indicated 
address (addr). 

;nB 



Cancel the indicated breakpoint (n). 



;B 

Cancel all breakpoints. 

addr;nR 

Set one of the eight available relocation registers (n) to the 
relocation constant value indicated by addr. 



^Only a very few of the available debugging commands have been demon- 
strated in this chapter. Consult the RT-11 System Utilities Manual for all 
ODT commands. 
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$n 



Open one of the eight general registers (n) for examination 
and possible modification. 

) 

Use the contents of the currently open location as an address; 
close the currently open location; go to the new address, and 
open it for examination and possible modification. 

Print on the console terminal the low-order byte of the cur- 
rently open location; if possible, convert the value to an 
ASCII code and print the corresponding character on the ter- 
minal. 



Changes you make with ODT are temporary. Therefore you 
should now use the editor to correct the source program 
SUM.MAC. You should edit line 40 so that it reads: 



FILE MAINTENANCE 



ADD 



«10. + '0 »R0 



;make digit ascii 



The file SUM.MAC is currently stored on the storage volume 
VOL:. Edit this file, then reassemble, relink, and rerun it to 
verify that it is correct. When you have done this, store the 
updated version of the source file on the storage volume under 
the same name (SUM.MAC), including the files SUM.OBJ and 
SUM.SAV. 

After you have corrected and rerun the program, continue on to 
Chapter 15, or go back and perform one of the other language 
demonstrations. Refer to the reading path outlined in the 
Preface. 



RT-ll System Utilities Manual (AA-M239A-TC). Maynard, Mass.: Digital 
Equipment Corporation, 1983. 

A guide to the use of the RT-11 system utilities. 



REFERENCE 
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CHAPTER 15 
USING THE FOREGROUND/BACKGROUND MONITOR 



A special feature of the RT-11 operating system is that it pro- 
vides a choice of operating environments. You are using its 
foreground/background environment. This environment allows 
two independent programs to reside in memory at the same 
time and to execute concurrently. 

You have used the foreground/background (FB) monitor to con- 
trol the system and to perform the various exercises in this 
manual. 



The foreground/background environment is designed so that 
two programs can — but need not — share memory and run 
concurrently. One of these programs you designate as the fore- 
ground program. The system gives priority to the foreground 
program (or job, as it is usually called) and allows it to run until 
some condition, perhaps waiting for an I/O completion, causes it 
to relinquish control to the other program (the background job). 
The system then allows the background job to run until the 
foreground job again requires control, and so on. In this way, 
the two programs share system resources. Whenever the fore- 
ground program is idle, the background program runs. Yet 
whenever the foreground program requires service, its requests 
are immediately satisfied. To the user at the terminal, the two 
programs appear to run simultaneously. 

Foreground priority programs are generally time-critical. For 
example, you may want to designate as the foreground job a 
program that collects and analyzes data. Background programs 
are usually non- time-critical. Thus, you can continue to do pro- 
gram development as the background job by using monitor com- 
mands to run the editor, the FORTRAN IV com.piler, the linker, 
and so forth. 

In order to perform the following exercises your system must 
have a clock. Verify whether your system has a clock by en- 
tering the TIME command twice. If the time displayed changes, 
your system has a clock. If your system does not have a clock 
you should skip ahead to Chanter 16. 



THE 
FOREGROUND/ 
BACKGROUND 
ENVIRONMENT 



Two programs are provided for you to run a foreground/back- 
ground demonstration. These programs reside on your system 
volume. The background job is called DEMOB G, and the fore- 
ground job DEMOFG. The function of the foreground job is to 
send messages every two seconds to the background job, telling 
it to ring the terminal bell. The background job recognizes 



RUNNING THE 

FOREGROUND/ 

BACKGROUND 

PROGRAMS 
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these messages and rings the bell once for each message sent by 
the foreground job. 

Although the foreground job is always active, sending messages 
to the background job every two seconds, other programs be- 
sides DEMOBG can be executed in the background. Only when 
DEMOBG is active, however, is the circuit complete so that 
messages can be successfully received and honored. During the 
periods when DEMOBG is not running, the foreground pro- 
gram enters the messages in the monitor message queue. Once 
you restart DEMOBG in the background, the system immedi- 
ately dequeues all the messages since the last exit of DEMOBG, 
resulting in many successive bell rings. When the queue is 
empty, the normal send/receive cycle resumes, and the bell 
rings every two seconds as each current message is sent and 
honored. 



Creating the 
Background Job 



The background program DEMOBG.MAC is an assembly lan- 
guage source file and must be assembled and linked before you 
can use it. When you execute DEMOBG, it displays a message 
on the terminal. It is assumed that you have set the date. 



Editing the 
Background Job 



Use the text editor to modify the background job, 
DEMOBG.MAC. One of the lines of the message that is output 
by the program has a semicolon character preceding it, which 
makes the line a comment field. This will prevent the line from 
being printed as part of the message. Thus, the semicolon must 
be deleted from that line. 

Change the line 

! .ASCII /WELL DONE./ 



to 



.ASCII /WELL DONE./ 



Running the 
Backfiround Job 



If you performed the demonstration in Chapter 11, you are al- 
ready familiar with assembly/link operations, and the following 
command explanations can serve as a review. If you did not 
read Chapter 11, simply type the command lines as shown. 

Assemble the background job. 
Long Command Format 

.MACRO® 

Files? DEMDBG/LISTdSl 
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Short Command Format 

.MACRO DEMOBG/LIST® 

Link the .OBJ file produced by the assembler to create a run- 
nable job. 



Long Command Format 

.LINKED 

Files? DEMOBG(bSI 



Short Command Format 

.LINK DEMOBG® 

Now run the background job and check the results. 

.RUN DEMOBGiS 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED. THIS IS THE LAST LINE. 

WELL DONE. 

If you did not delete the semicolon character, the last line will 
not be output. Return to the monitor by typing two successive 
CTRL/Cs. 



ICTRL/C) 
(CTRL/C] 

•-C 

"C 



The FB monitor provides you with commands that allow you to 
control the two-job environment. They let you interact with the 
two jobs and let the two jobs interact with one another. 



USING THE 
FB MONITOR 



When two jobs run simultaneously, you must have some means 
of indicating the job to which you are directing commands. 
Likewise, the two jobs must have the means to identify them- 
selves when the'^ have messages to "rint. The follov/ins are 



sinmo fnTivonfinTiC! t^^^it ar\r\]'w fn airafom nnm 



TTmiT^l 



nai-i 



Tt-» o 4-T' 



J.X CI. u TV \j~ 



job environment. 

1. The foreground job has priority. If both the foreground and 
the background job are ready to print output at the same 
time, the foreground job prints first. The foreground job 
prints a complete line, then the background job prints a 
complete line, and so on. 



Communication 
in a Two-Job 
Environment 
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2. Either job can interrupt your input at the terminal if it has 
a message to print. 

3. Messages printed by the background job are preceded by the 
characters B>. 

4. Messages printed by the foreground job are preceded by the 
characters F>. 

5. Typed commands are initially directed to the background 
job. You can redirect control alternately to the foreground 
and background jobs by using the CTRL/F and CTRL/B 
commands. 

To direct typed input to the foreground job, type CTRL/F. 
This command instructs the monitor that all subsequent 
terminal input — commands and text — is directed to the 
foreground job. T3^ping this command causes the system to 
print an F> on the terminal, unless output is already 
coming from the foreground job. Command input remains 
directed to the foreground job until the foreground job ter- 
minates, or until it is redirected to the background job 
through CTRL/B. 

To direct typed input to the background job, type CTRL/B. 
This command instructs the monitor that all subsequent 
terminal input — commands and text — is directed to the 
background job. Typing this command causes the system to 
print a B> on the terminal, unless output is already coming 
from the background job. Command input remains directed 
to the background job until redirected to the foreground job 
through CTRL/F. 



Creating the 
Foreground Job 



The foreground program DEMOFG is an assembly language 
source file; it must be assembled and linked before you can use 
it. 



Long Command Format 

.MACRO® 

Files? DEMOFG/LISTEl 



Short Command Format 

.MACRO DEMOFG/LIST® 



LINK/ 
FOREGROUND 



The output resulting from this MACRO command includes an 
object file called DEMOFG.OBJ and a listing file called 
DEMOFG.LST. The command creates both files on your system 
volume. You must link the .OBJ file to produce a runnable 
foreground program. You use the LINK command, just as you 
have in earlier chapters, but you also use the /FOREGROUND 
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option/ This option produces a load module with a .REL file 
type which signifies to the system that the file is a foreground 
program and is to be run as the priority job. 

Long Command Format 

.LINK/FOREGROUND® 
Files? DEMOFGiBi 

Short Command Format 

.LINK/FOREGROUND DEMOFG® 



Now you are ready to operate the two-job environment. Many 
times, you have to consider the devices that are used for output 
in a foreground/background environment. For example, if your 
program assumes that the output device is a line printer, and 
you do not have a line printer or you want to output to another 
device, use the ASSIGN command. Type this command in the 
following way, substituting the two-letter mnemonic from 
Table 4-2 for the storage volume in place of dd. 



Executing the 

Foreground and 

Background Jobs 



Long Command Format 

.ASSIGNED 

Physical device name? ddi 

Logical deyice name? LPsC 



Short Command Format 

♦ ASSIGN dd: LP:® 



You do not have to consider the above information for the dem- 
onstration programs that are provided, since the foreground job 
communicates with the background job, and both jobs send 
their output to the terminal. 

When you use the FB monitor, you must always load into 
memory the peripheral device handlers needed by the fore- 
ground job. You use the monitor LOAD command to make a 
device handler permanently resident in memory. For example, 
if your foreground job requires the use of the line printer, you 
must load the LP device handler. You must specify the jobtype 
with the command. For a foreground job, the jobtjme is F; for a 
background job, the jobtype is B. If you have assigned the code 
LP: to another device, the system automatically loads the as- 
signed handler and you need not enter a LOAD command. If 
you are using the line printer, tjrpe: 



LOAD 



^This command option also applies to compiled FORTRAN IV programs that 
are to be linked as a foreground job. 
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Long Command Format 

.LOAD® 

Dey ice? LP: =F(1B 



FRUN 



Short Command Format 

.LOAD LP:=F(rD 

The command to load and start execution of the foreground job 
is FRUN, which is similar to the RUN command except that 
the system automatically loads and starts the execution of the 
foreground .REL program. (To execute a FORTRAN IV fore- 
ground job, you must use the /BUFFER:n option with the 
FRUN command. The argument n represents, in octal, the 
number of words of memory to allocate.) Use this command to 
start the execution of DEMOFG.REL. 

Long and Short Command Format 

.FRUN DEMOFG® 



FOREGROUND DEMONSTRATION PROGRAM 

SENDS A MESSAGE TO THE BACKGROUND PROGRAM "DEMOBG" 

EMERY 2 SECONDS* TELLING IT TO RING THE BELL. 

B> 

The foreground program DEMOFG is now running and 
queuing the message for the background program every two 
seconds. You now execute the background program DEMOBG 
to allow it to receive the messages that were queued and to ring 
the bell. 



,RUN DEMOBG® 

RT-11 DEMONSTRATION PROGRAM 
IF INCORRECTLY EDITED* THIS 
WELL DONE. 



IS THE LAST LINE. 



The bell rings several times in rapid succession as the monitor 
dequeues the messages, and then every two seconds as the fore- 
ground job sends its message to the background job. 

You can run other jobs in the background. First, terminate the 
background job DEMOBG, using the double CTRL/C command. 

[CTRL/Cl 
(CTRL/C 1 



Execute a DIRECTORY command in the background to get a 
listing of all the .OBJ files on the system volume by typing: 

.DIRECTORY *.OBJ® 
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The foreground job is still running and queuing its messages to 
the monitor. Rerun the background program to collect all the 
foreground messages while the background job was stopped and 
the directory was printing. 

. RUN DEMOBG® 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

MELL DONE. 

The bell again rings several times in succession and then rings 
once every two seconds. Stop the background job by using the 
double CTRL/C command. 



fcTRLi C 1 
fcTRL; C ) 



Now stop the foreground job and remove it from memory. To do 
this, you must first use the CTRL/F command to direct terminal 
input to the foreground. Type: 



ItTRL; F 1 



F> 



The system prints the characters F> to remind you that you 
are now directing command input to the foreground job. Use the 
double CTRL/C command to interrupt and terminate the execu- 
tion of the foreground job, and return control to the background 
job. 



Cm;c) 

CTRL/C) 

B> 



You should unload the foreground job to reclaim memory space 
for background use. Use the monitor UNLOAD command as 
follows: 



UNLOAD 



Long and Short Command Format 

UNLOAD F® 



F represents the foreground job; you should use this code when- 
ever you want to unload the foreground job. To unload any 
loaded device handlers, you must use their two-letter device 
mnemonics. 

Check to see if the .LST files were produced as a result of this 
demonstration. 
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Long and Short Command Format 



, DIRECTORY *.LST 
08-Jan-83 

DEMOBG.LST a 08- 
2 Filest 10 BlooKs 
408 Free blocKs 



Jan-83 



DEMOFG.LST 



08-Jan-83 



The foreground program has access to all the system features 
available to a background program — opening and closing 
files, reading and writing data, and so on. However, before you 
begin to write and use programs in the foreground, read the 
RT-11 Software Support Manual for coding restrictions. 



SUMMARY: 
COMMANDS USED 
IN AN FB 
ENVIRONMENT 



CTRL/B 

Direct all keyboard input to the background job (until 
CTRL/F). 

CTRL/F 

Direct all keyboard input to the foreground job (until 
CTRL/B). 

FRUN 

Load and start execution of the foreground job. 

LOAD dd 
Bring the indicated device handler into memory; the handler 
becomes resident in memory. 

UNLOAD dd 

Take the indicated device handler out of memory, reclaiming 
its memory space; the handler becomes nonresident in 
memory. 

UNLOAD F 

Reclaim the memory space used by the foreground job. 



FILE MAmiEHAHCE 



You assembled the source file DEMOFG.MAC and produced an 
.OBJ file, linking it to produce DEMOFG.REL. You also cre- 
ated a .LST file named DEMOFG.LST on your system volume. 
You should save on your storage volume the files 
DEMOFG.REL and DEMOFG.MAC, and delete from your 
system volume the files DEMOFG.OBJ and DEMOFG.LST. Do 
not delete DEMOFG.MAC, since this file was distributed as 
part of the RT-11 operating system. Do the same for the file 
DEMOBG, which you created as a .SAV file instead of a .REL 
file. 



Version 5.1, July 1984 
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Long Command Format 

.COPY® 

FroM? DEMOFG.MACtDEMOFG.RELiEl 

To ? MOL:*.*® 

Files copied: 
DKsDEMQFG.MAC to MOL : DEMDFG . MAC 
DKiDEMOFG.REL to MOL : DEMDFG . REL 

.DELETE® 

Files? DEMOFG.OBJ tOEMOFG.LBT® 



Short Command Format 

.COPY DEMOFG.MACtDEMDFG.REL U0L:*.*8 
Files copied: 
DK:DEMOFG.MAC to VOL s DEMOFG . MAC 
DK:DEMOFG.REL to UOL : DEMOFG . REL 

.DELETE DEMOFG. OBJ. DEMOFG. LST® 



Finally, obtain a brief directory listing of your storage volume 
so that you can see its current status: 

Long and Short Command Format 

.DIRECTORY/BRIEF MOL:® 



RT-11 Software Support Manual (AA-H379B-TC). Maynard, Mass.: Digital 
Equipment Corporation, 1983. 

A technical manual providing RT-11 programming concepts. 

RT-11 System User's Guide (AA-5279C-TC). Maynard, Mass.: Digital Equip- 
ment Corporation, 1983. 

A guide to the use of the RT-11 operating system. 



REFERENCES 
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CHAPTER 16 
USING INDIRECT FILES 



The RT-11 system provides an operational aid called an indi- 
rect file, which allows the system to run unattended. An indi- 
rect file is a file composed entirely of monitor operating com- 
mands. When you start the execution of the indirect file, the 
monitor processes these commands in consecutive order. So 
once you have created an indirect file and started its execution, 
you can direct your attention to other tasks or even physically 
leave the system, since the monitor executes the commands au- 
tomatically and consecutively. "^ 

The kinds of operations that RT-11 can best perform in an 
indirect file are those that involve much computer processing 
but that do not require your supervision or intervention. For 
example, multiple assemblies, compilations, and data transfer 
operations are ideal operations for indirect file processing. Also, 
any series of commands that you are likely to type often can 
easily run as an indirect file. 



Use the editor to create an indirect file as a text file. You can 
call the file by any file name you wish, but you should give it a 
file type of .COM, since this file type is the default used by the 
monitor to locate the file. 

You structure the lines of text that make up an indirect file just 
like keyboard input. Thus, if you were to list the indirect file it 
would look like terminal keyboard text without any monitor 
prompts. 



CREATING AN 
INDIRECT FILE 



You enter monitor commands into the indirect file as you would 
on the terminal. As an example, both of the following accom- 
plish the same operation when executed as part of an indirect 
file: 



Entering Monitor 
Commands 



COPYdl 

INFIL.MACESI 

OUTFIL.MACESI 



Since monitor prompts are not included in the indirect file, 
using the long command format requires that you anticipate 



^The indirect file concept is similar to BATCH processing. Although indirect 
files lack many of the BATCH capabilities, they are easier to use than 
BATCH. (The RT-11 computer system also supports a BATCH processor, as 
described in the RT-11 System Utilities Manual.) 
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each prompt and its proper response. It is suggested that you 
use the short command format and enter the command as a 
single line of text. Terminate each command line with a car- 
riage return. 



Using the Editor 
to Create an 
indirect Fiie 



The indirect file that you will now create incorporates several 
of the commands previously demonstrated in this manual. Thus 
it serves both as an example of the format of indirect file input 
and as a brief review of the monitor commands used to copy, 
process, and delete files. In addition, one new command, DEAS- 
SIGN, is demonstrated. 

List a directory of your storage volume. The only files that 
should appear in the listing are GRAPH.FOR, SUM.MAC, and 
MATCH.BAS. All three files will be in the directory only if you 
performed the exercises for all three languages (FORTRAN IV, 
MACRO-11, and BASIC-11). 

Long and Short Command Format 

.DIRECTORY VOL:® 

OB-JAN-83 
SUM .MAC 3 08-JAN-83 MATCH .BAS 3 08-JAN-83 
GRAPH .FOR 2 08-JAN-B3 

3 Files* 8 Blocks 

4754 Free blocks 

If any other files are listed, delete them using the DELETE 
command before you create the indirect file. 

Use the EDIT/CREATE monitor command to create a file called 
INDCT.COM, inserting the commands according to the direc- 
tions in the right-hand column. When you have finished cre- 
ating the file, list it and check for typing errors. Correct any 
errors you find, and then close the file, using the EX editing 
command. 

Long and Short Command Format 



.EDIT/CREATE INDCT.COM® 
#IDATE 8-JAN-B3(aHl 
TIME SiOOiOOBS) 



DATE® 



de;assign® 



ASSIGN TT: LP: 



ASSIGN ddn yOL: 



Enter a hypothetical date 
and time (if your system has 
a clock). 

Print the date. 

Deassign all previous device 
assignments and set new 
ones as follows: 

Assign the logical name LP: 
to the terminal. 

Assign the logical name 
VOL: to the storage volume 
(dd). 
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DIRECTORY/BRIEF yoL:B List an abbreviated direc- 

tory of VOL:. 

COPY yoLsGRAPH. FOR GRAPH. forS FORTRAN IV users insert 

this command to copy the 
FORTRAN IV demo pro- 
gram to the system volume. 

COPY MOLiSUM.MAC SUM. MAC® MACRO-11 users insert 

this command to copy the 
MACRO-11 demo program 
to the system volume. 

COPY i.'OL:MATcM'.BAS MATCH . BAS® BASIC-11 users insert this 

command to copy the BA- 
SIC-11 demo program to 
the system volume. 

FORTRAN/LIST GRAPH®) FORTRAN IV usors who do 

LINK/MAP GRAPH, SYSLiB.FORLiB® ^ot need to load the lan- 
guage volume include these 
commands to compile and 
link the FORTRAN IV 
demo program. 

MACRO/LiST/CROssREFERENCE SUM® All users assemble and link 

LINK/MAP SUM® ,i j 

the demo program. 

RENAME MATCH. BAS MATCH. MAP® BASIC-11 users simply re- 

name the demo program. 

MACRO/LIST/CROSSREFERENCE DEMOFG®. 

LiNK/FOREGROUND/MAP All users assemble and link 

^E^of^G® the DEMOFG file. 

DIRECTORY ».oBJ® List a directory of object 

files. 

DELETE/NoouERY GRAPH.*® FORTRAN IV users delete 

the GRAPH files. 

DELETE/NOQUERY suM.#® MACRO-11 users delete 

the SUM files. 

DELETE MATCH. MAP® BASIC-11 users delete the 

MATCH file. 

DFAS.5IGN® DenHHicrn all rloin^o aaoicrn. 

ments. 

TIME® If your system has a clock, 

print the time to show how 
long total processing took. 

IDIli Terminate the insert com- 

fj^mm mand and list the indirect 

DATE 8-JAN-B3 _c-i j_ i i r. /t-, 

TIME 8:00:00 hie to chock f or errors. (Ex- 

ample input is shown here.) 
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DATE 

DEASSIGN 

ASSIGN TT: LP; 

ASSIGN RKl! VOL: 

DIRECTORY/BRIEF yOL: 

COPY yOLiGRAPH.FOR GRAPH. FOR 

COPY i.'DL:SUM,MAC SUM. MAC 

COPY yOL:MATCH.BAS MATCH. BAS 

FORTRAN/LIST GRAPH 

LINK/MAP GRAPH iSYSLIB.FORLIB 

MACRD/LIST/CROSSREFERENCE SUM 

LINK/MAP SUM 

RENAME MATCH. BAS MATCH. MAP 

MACRO/LIST/CROSSREFERENCE DEMOFG 

LINK/FOREGROUND/MAP DEMOFG 

DIRECTORY #.OBJ 

DELETE/NDOUERY GRAPH.* 

DELETE/NOOUERY SUM.* 

DELETE MATCH. MAP 

DEASSIGN 

TIME 

*E> 



Close the file INDCT.COM. 



EXECUTING AN 
INDIRECT FILE 



Once you have created an indirect file and checked it for errors, 
you are ready to start its execution. The command to start exe- 
cution of an indirect file is the at sign (@) followed by the 
appropriate file name (the file tj^e .COM is assumed unless 
you indicate otherwise). Execution starts immediately, and the 
system processes commands in the indirect file in consecutive 
order. Each command is echoed on the terminal as it is pro- 
cessed. If an error within the indirect file affects the processing 
of a command, the system prints a system message on the ter- 
minal and stops execution of the entire file. Therefore, it is 
particularly important that you check your indirect file for er- 
rors before you start it and then leave the area. You can stop 
execution of an indirect file at any time by typing two 
CTRL/Cs. 

Run the indirect file that you have just created by typing: 



.eiNDCT® 

It takes a minute or two for the commands in this file to be 
processed and for the listings to print. If your system has a 
clock, the time printed at the end of execution tells you exactly 
how long command processing has taken. Following is an ex- 
ample run. 



■eiNDCT 

.DATE B-JAN-B3 

.TIME b:oo:oo 

.DATE 
B-Jan-S3 

.DEASSIGN 

.ASSIGN TT! LP! 

.ASSIGN RKl! UOL! 

.DIRECTDRY/DRIEF VDL ! 

0B-Jan-B3 
GRAPH .FBI* SUM .MAC MATCH .BAS 

3 Piles. 8 Blocl'S 

A?5A Free blocl-.s 

.CDPY VOL! GRAPH. FOR GRAPH . FOR 
.COPY yOL!SUM.HAC SUM . MAC 



16-4 



.COPY VOLiHATCH.BAS HATCH. BAS 



Using Indirect Files 



Snt OS-Jan-83 08:00:i6 



PAGE 001 



C GRAPH. FOR VERSIDN 1 

C THIS PROGRAM PRODUCES A PLOT ON THE TERMINAL 

C OF AN EXTERNAL FUNCTIDNt FUN<X.T) 

C THE LIMITS OF THE PLOT ARE DETERMINED BY THE DATA STATEMENTS 

C "STAB* IS FILLED UITH A TABLE OF HEIGHT FLAGS 

C "STRING" IS USED TO BUILD A LINE OF GRAPH FDR PRINTING 

0001 SCALtZMIN.ZMAX.MAXZ.K)nZMINtFLOAT(K-l»K2HftX-ZMIHJ/FL0AT(HAXZ-l) 

0002 LOGICAL*! STRIN0(133) .STAB(IOO) 

0003 DATA XMIN.XMAX.MAXX/-5. 0.5. 0.45/ 

0004 DATA YHIN.YMAX.MAXY/-S. 0.5.0.72/ 

0005 DATA FHIN.FMAX/O.Ofl.O/ 

OOOA CALL SCOPYC- l2345i7B9 +' .STAB) 

0007 MAXF=LEN{STAB) 

0008 DO 20 IX=1.MAXX 

0009 X=SCAL(XMIN.XHAX.MAXX»IX) 

0010 CALL REPEATC*'. STRING. HAXY) 

0011 IFCIX.EQ.l .OR. IX.EO.HAXX) GOTO 20 

0013 DO 10 IY=2.MAXY-1 

0014 Y=SCAL(YMIN.YMfiX.MAXY.IY) 

0015 IFUN=2+INT(FL0AT(MAXF-3)»(FUN(X.Y)-FMIN>/<FHAX-FMIH)) 

0016 10 STRING(IY)=STAB<MINO(MAXF.MAXO<1.IFUN>)) 

0017 20 CALL PUTSTR(7. STRING. ' ') 
CALL EXIT 
END 



0019 

.MAIN. 

fFDRTRAN-I-C.MAIN.D Errors! 0. 

FORTRAN lU StopaSe Hap fo 

Local Variables. .PSECT *DATA. 



Offset 
000402 
000434 
000432 
000426 
000352 
000364 



Uari 



- Prod 


ram Unit 


.HAIN. 






Size 


= 000470 


( 156. > 


jords) 




TuPe 


Offset 


Name 


T«PQ 


Offset 


RX4 


000374 


IFUN 


I«2 


000450 


I«2 


000442 


K 


1*2 


000430 


I«2 


000362 


MAXY 


1*2 


000374 


R«4 


000436 


XHAX 


R*4 


000356 


Rt4 


000444 


YMAX 


R*4 


000370 


R»4 


000422 ■ 


ZMIN 


R*4 


000416 



HAXF 

MAXZ 
XHIN 
YMIN 



Local and COMMON Arraus: 

Nans Twptj Section Offset Size Dinensioi 

STAB L*l «DATA 000205 000144 ( 50.) (100) 

STRING L*l »DATfl 000000 000205 ( 67.) <133) 



Subroutines r Functloi 



Statement and Pi 



-Defined Functioi 



Nane Type 


Name Tupb Name Tupe Name Tmps 


Name 


Type 


EXIT R*4 


FLOAT R*4 FUN R*4 INT 1*2 


LEN 


1*2 


HAXO 1*2 


MINO I«2 PUTSTR R*4 REPEAT R*4 


SCAL 


R*4 


SCOPY R*4 








FORTRAN lU 


V02.5 Sat 08-Jan-B3 0Bt01t46 




PAOE 001 


0001 


FUNCTION FUN<XfY) 






0002 


R-SQRT(X*»2+Y«*2> 






0003 


FUN-<X»Y«R*EXP(-R))««2 






0004 


RETURN 






0005 


END 






FUN 








FORTRAN IV 


Storaae Map for ProSram Unit FUN 






Local Uariablest .PSECT tDATA. Sis* " 000024 ( 10. u 


lords) 




Na>B TwPO 


Offset Name Twpe Offset Name - 


Tape 


Offset 


FUN R*4 


000004 Eav R R*4 000010 X 


R*4 


000000 



R«4 000002 



Subroutines . Functii 



Statement anc 



'ssor-Daf ined Functii 



•LINK/HAP GRAPHfSYSLIBtFORLIB 



RT-ll LINK y08 


.00 


Load Hap 


Saturday OS-Jan 


I-B3 ob:o 


<2 Page 


GRAPH .SM 


Title! 


■MAIN. 


Identl 


FORV02 








Section Addr 


Size 


Global 


Value 


Global 


Value 


Global 


Value 


. ABS. 000000 


001000 


= 256. 


words 


(RU.I.DeL.ABS.OyR) 








«USRSU 


000000 


•RF2AI 


000000 


•HRDUR 


000000 






.VIR 


000000 


•NLCHN 


000006 


«SYSU» 


000012 






•UASIZ 


000152 


•LRECL 


000210 


•TRACE 


004737 


OTS»I 001000 


017722 


- 4073. 


words 


(RW.I.LCL.REL.CDN) 








»»OTSI 


001000 


•CVTIF 


001000 


•CVTIC 


001014 






iCMTID 


001014 


CCI» 


001026 


CDI^ 


001026 






>IC 


001026 


• ID 


001026 


CFl^ 


001042 






»IR 


001042 


EXP 


001126 


ADF^IS 


001466 






ADFtPS 


001474 


SUF«PS 


001500 


SUF^HS 


001504 






ADF*HS 


001516 


SUF^IS 


001526 


•ADDF 


001S34 






«SUBF 


001550 


5UF*S5 


001562 


• SBR 


001562 






ADF*5S 


001566 


•ADR 


001566 


ADD^ 


001602 






DIFIPS 


002226 


DIF^HS 


002232 


DIF^IS 


002242 






•DIUF 


0022S0 


DIF^SS 


003262 


•DUR 


002262 






MUF«PS 


0025S0 


MUF^MS 


002554 


HUF^IS 


002564 






«HULF 


002572 


MUF^SS 


002604 


•HLR 


002604 






*OTI 


003142 


• »OTI 


003144 


•SETOP 


003354 






• •SET 


005026 


SORT 


005322 


STK»L 


003516 






STMI 


005522 


STK^F 


005526 


lOR* 


005536 






AND^ 


003542 


EQVl 


005550 


XQRt 


00S552 






NHI^IH 


005S66 


NHI»1I 


005600 


BLEI 


005610 






BEO^ 


005612 


BGT« 


005620 


BGE^ 


005622 






BRA^ 


005624 


BNE* 


005630 


BLT» 


005632 






CAIS 


005642 


CALS 


005650 


ENDS 


005700 






ERR« 


005712 


• END 


005724 


•ERR 


005742 






SOPNER 


005764 


•CHKER 


006022 


•lOEXI 


006046 






•EOL 


006114 


EGLS 


006116 


EXIT 


006232 






HDF^SS 


006236 


HOF*HS 


006250 


HOF»PS 


006262 






HOFSSM 


006266 


HOFSSP 


006276 


MOF«MM 


006302 






HOF^KA 


006314 


MOF»MP 


006322 


MOF^PM 


006330 






HOFIPA 


006334 


MDF^PP 


006340 


MOF»RS 


006344 






HOF^RM 


0063S2 


MOF^RA 


006362 


HOF^RP 


006366 






NGD»S 


006372 


NGF^S 


006372 


NGDIH 


006404 






NGF«H 


006404 


NGD^P 


006420 


NGF»P 


006420 






NGDIA 


006424 


NGF^A 


006424 


ADI^SS 


006430 






ADISSA 


006434 


ADI«SH 


006440 


ADI^IS 


006444 






ADHIA 


006450 


ADI^IH 


006454 


ADI^MS 


006460 






ADMMA 


006464 


ADI^MH 


006470 


CNISSS 


006474 






CHI»SI 


006500 


CMI^SH 


006S04 


CHILIS 


006510 






CMI^II 


006=14 


CMI»IH 


006520 


CHICHS 


006524 






CHICHI 


006530 


CMIfMH 


006534 


IFU* 


006540 






• IFU 


006544 


••IFU 


006550 


IFU«« 


006606 






HOURS 


006656 


H0LSR5 


006656 


MOI^RH 


006662 






MOI«RP 


006666 


MOISRA 


00A670 


MOI*SS 


006674 






MOL«SS 


006674 


MOI^SH 


006700 


HOI^SA 


006704 






HOIIIS 


006710 


HOL^IS 


006710 


REL^ 


006710 






HOIflH 


006714 


MOI»IA 


006720 


MOI^HS 


006724 






MOI«HH 


006730 


M0I»MA 


006734 


HOI»OS 


006740 






MOI^OM 


006744 


HOI^OA 


006750 


HOI^IS 


006754 






K0I*1M 


006762 


MDI^IA 


006770 


ICI^S 


006776 






ICI«H 


007002 


ICI^P 


007006 


ICI^A 


007010 






DCK5 


007014 


DCI«M 


007020 


DCI»P 


007024 






DCI«A 


007026 


IDINT 


007032 


INT 


007032 






MOItIP 


007060 


HOISSP 


007062 


MDI^PP 


007070 


RT-ll LINK UOa. 


.00 


Load Map 


Saturday OB-Jan 


-63 08:02 Pa90 


GRAPH .SAU 


Title! 


.HAIN. 


Ident! 


FDRV02 












HOKHP 


007074 


MOI«PS 


007104 


HOUPM 


007112 






HOUPA 


007120 


H01«0P 


007126 


HOItlP 


007134 






I3H» 


007144 


•ISNTR 


0071S0 


LSN« 


007164 






•LSNTR 


007170 


SUItSS 


007324 


SUI«SA 


007330 






SUIkSH 


007334 


SUItIS 


007340 


SUHIA 


007344 






SUHIM 


007350 


SUItHS 


007354 


SUI«HA 


007360 






SUItHH 


007364 


H0L«SH 


007370 


HOL»SA 


007374 






HOL^MS 


007400 


HGLtHH 


007410 


HOL»HA 


007414 






HOL^SP 


007420 


HOL»PP 


007426 


MOL^MP 


007432 






HOL«PM 


007442 


M0L»PS 


007450 


HOLtPA 


007454 






HOLtlH 


007462 


HaL«IA 


007470 


HOU«IP 


007476 
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LUES 


007506 


UED^ 


007510 


LQT« 


007516 








LOE* 


007520 


LNE» ■ 


007530 


LLT» 


007532 








TSL^S 


007536 


T3L»M 


007342 


TSL^I 


00754A 








TSL»P 


007334 


HAXO 


007362 


MINO 


007606 








RET«L 


007632 


RET»F 


007636 


RET^I 


007644 








RET* 


007646 


•DTIS 


007702 


••OTIS 


007704 








TVL» 


010024 


• TVL 


010024 


TVF« 


010032 








•TVF 


010032 


TVD^ 


010040 


•TVD 


010040 








TVQ« 


010044 


«TUO 


010046 


TVP» 


010054 








•TVP 


010054 


TVl^ 


010062 


•TVI 


010062 








SAL«IM 


010216 


SAL^SH 


010220 


SVL«IH 


010224 








SVL«SH 


010226 


SAL^MM 


010234 


SVL^MM 


010240 








SAUIP 


010244 


SAL«SP 


010246 


SVL*IP 


010252 








SUL^SP 


010254 


SAL^HP 


010262 


SyL«MP 


010266 








•CyiFB 


010272 


•CVTFI 


010272 


•CVTCB 


010306 








•CVTCI 


010306 


•CVTDB 


010306 


•CUTDI 


010306 








CIC^ 


010320 


CID» 


010320 


CLC^ 


010320 








CLD^ 


010320 


«DI 


010320 


CIF^ 


010330 








CLF« 


010330 


•RI 


010330 


CIL« 


010442 








CLI^ 


010444 


•INITI 


010450 


•CLOSE 


010566 








•ERRTB 


011344 


•ERRS 


011451 


•FCHNL 


01S212 








•FIO 


016054 


• •FIO 


016060 


•PUTRE 


017224 








•PUTBL 


017532 


•GETBL 


017742 


•EDFIL 


020126 








•E0F2 


020142 


SAVRG^ 


020162 


THRD* 


020340 








•STPS 


020342 


STP» 


020350 


•STP 


020350 








FOOi 


020354 


•EXIT 


020374 


•UAIT 


020520 








•WRINT 


020562 


•DUHPL 


020574 






OJStP 


020722 


000054 


=■ 22, 


uords 


(RUrDrGBL>REL>OVR) 




SYS«I 


020776 


000244 


=■ B2. 


words 


{RU.I.LCLfREL.CON) 










LEN 


020776 


REPEAT 


021014 


SCOPY 


021146 


USER«I 


021242 


000000 


o 0. 


uords 


<RW,IrLCL.RELFCON) 




•CODE 


0212-12 


001316 


= 359. 


uords 


(RW.lFLCL»RELtCONJ 










••OTSC 


021242 


FUN 


022120 


PUTSTR 


022266 


QTS»D 


022560 


001036 


= 271. 


uords 


<RUfI.LCL.REL. CON) 










•»DTSO 


022560 


•OPEN 


022560 






SYS»0 


023616 


000000 


=■ 0. 


uords 


(RUfIfLCLfREL.CDN) 




iDATAP 


023616 


000106 


= 35. 


uords 


<RU.DFLCLFRELrCaN> 




OTS«D 


023721 


000006 


= 3. 


uords 


(RUfDfLCLfREL.CONJ 










NHCLN* 


023730 










DTS»S 


023732 


000002 


= I. 


uords 


(RU.D.LCL.REL.CON) 










•ADTS 


023732 










5YS«5 


023734 


000004 


= 2. 


uords 


(RU.DfLCL.REL.CON) 










•SYSLB 


023734 


♦LOCK 


023736 


•CRASH 


023737 


• DATA 


023740 


000536 


= 175. 


uords 


(RU.D.LCL.REL.COH) 




UBERtD 


024476 


000000 


a 0. 


uords 


(RU.D.LCL.REL.CON) 




.••St. 


024476 


000000 


= 0. 


uords 


fRU.D.GBL.REL.OVR) 




RT-il LINK V08, 


,00 


Load Ha 


p 


Saturday OS-Jsn- 


-B3 OB:02 Page 


GRAPH .SAV 


Title: 


.HAIN. 


Ident: 


FDRV02 









' 021242. Hidh limit =■ 024474 = 



■daa 08-Jan-83 ( 



.TITLE SUM. MAC VERSION 1 
.MCALL .TTYOUT. .EXIT. .PRINT 



10 

11 000000 

12 000006 

13 000012 

14 000016 

15 000022 

16 000024 

17 000026 
IB 000030 

19 000032 

20 000034 

21 000036 

22 000040 

23 000044 

24 000046 

25 000052 

27 000054 
2B O0OOS6 

29 000060 

30 000062 



N = 70. (NO. OF DIGITS OF 'E' TO CALCULATE 

'E' = THE SUM OF THE RECIPROCALS OF THE FACTORIALS 
1/01 + 1/11 + 1/21 + 1/31 + 1/41 + 1/51 + ... 



012705 000106 

012700 000107 

012701 000124' 
006311 
011146 

006311 

006311 

062621 

005300 

001371 

012700 000106 

014103 

012702 177777 
005202 

160003 
103375 
060003 
010311 



.PRINT ♦MESSAO 



32 000064 060261 
33 

34 000070 005300 

35 000072 001364 

36 000074 014100 

37 000076 



38 

39 000102 

40 000104 

41 000110 

42 000114 

43 000116 

44 000120 

45 000122 
44 

47 000124 



. 000342 
000345 
000350 
000353 
000356 
000361 
000364 



3700 000012 



005011 
005305 

001334 



FIRST: 


MOV 


♦N+l.RO 




HOU 


♦A,R1 


second: 


ASL 


BRl 




HOU 


BRl.-(SP) 




ASL 


ORl 




ASL 


CRl 




ADD 


(SP)+.(R1)- 




DEC 


RO 




BNE 


SECOND 




MOW 


#N.RO 


third: 


MOV 


-(R1).R3 




MOV 


♦-1.R2 


fourth: 


INC 


R2 




SUB 


R0.R3 




BCC 


FOURTH 




ADD 


R0fR3 




MOV 


R3fBR1 




ADD 


R2f-2(RU 




DEC 


RO 




BNE 


THIRD 




HDV 


-<R1>fR0 


fifth: 


SUB 


*10..R0 




BCC 


FIFTH 




ADD 


*10.+'0.RO 




.TTYOUT 






CLR 


I?R1 




DEC 


R5 




BNE 


FIRST 




.EXIT 




a: 


.rept 

.UORD 

.endr 


N-H 
1 


HESSAG : 


.ASCII 


/THE VALUE 



SPRINT INTRODUCTORY TEXT 
•!N0. OF CHARS OF 'E' TO PRINT 
(NO. OF DIGITS OF- ACCURACY 
(ADDRESS OF DIGIT VECTOR 
(DO MULTIPLY BY 10 (DECIMAL) 
(SAVE *2 
i*A 
f*8 

iNOU «10r POINT TO NEXT DIGIT 
(AT END OF DIGITS? 
(BRANCH IF NOT 

(GO THRU ALL PLACES. DIVIDING 
(BY THE PLACES INDEX 
(INIT QUOTIENT REGISTER 
(BUMP QUOTIENT 

(SUBTRACT LOOP ISN'T BAD 

(NUMERATOR IS ALWAYS < 10*N 

fFIX REMAINDER 

(SAVE REMAINDER AS BASIS 

(FOR NEXT DIGIT 

(GREATEST INTEGER CARRIES 

(TO GIVE DIGIT 

(AT END OF DIGIT VECTOR? 

(BRANCH IF NOT 

(GET DIGIT TO OUTPUT 

(FIX THE 2.7 TO .7 SO 

(THAT IT IS ONLY 1 DIGIT 

((REALLY DIVIDE BY 10) 

(MAKE DIGIT ASCII 

(OUTPUT THE DIGIT 

(CLEAR NEXT DIGIT LOCATION 

(MORE DIGITS TO PRINT? 

(BRANCH IF YES 

(UE ARE DONE 



(INIT VECTOR TO ALL ONES 



/THE VALUE OF E IS:/ <1S><12> /2./ <200> 



SUM. MAC VERSION 1 



MACRO V05.00 Saturdau 0B-Jan-B3 0B:07 Pa3e 



MACRO V05.00 Saturday 



.EVEN 
.END 



EXP 
. ABS. 



000000 000 

000372 001 

detected: 

len.bler stotistii 



Operating s^jstei 



3222 Words I 
15616 Uords 
RT-11 



iB-Jan-83 08107 Paa< 



lEXP 


1-11* 


1-54 


FIFTH 


1-37* 


1-39 


FIRST 


1-13* 


1-44 


FOURTH 


1-25* 


1-2Q 


HESSAG 


1-11 


1-Sl* 


N 


1-7* 


1-12 


SECOND 


1-15* 


1-21 


THIRD 


1-23* 


1-35 
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IB-Jan-83 0B:07 Pase H-: 



.EXIT l-3« l-AZ 
.PRINT I-3« 1-11 
•TTYOU l-3» 1-41 

.LINK/HAP SUN 

RT-11 LINK VOB.OO Losd Map Saturday 08-Jan-83 08! 11 Pmi9 1 

SUH .SAV Title! SUM. MA Ident! 



Sactlon Addr 



Global Value QIabal Value Global Vslui 



Transfer address = 001000. Hidh li«; 

.RENAME MATCH. HAS MATCH. MAP 



= 001370 1 380. 



8 000000 
? 00000& 

10 000020 

11 000054 

12 






START'. 


.PRINT 
.aSET 
.MRKT 
.SPND 


«MSG 

4QUEUE>«100. 

*AREAr*TIHE»tMKTC 


*1 


13 






' 


MKTIM COMPLETION ROUTINE 




IS 000062 
li 000070 
17 000072 
IB 00012i 

19 000132 

20 000146 
21 

22 
23 

24 000170 

25 000174 


026727 
003020 

0052A7 

000207 


000314 
000250 


000132 HKTC: 
MKTCl! 


CMP MSGCNTf490. 

BGT MKTCl 

.SDATC *AREfl.#BUFFER-*l- 

INC MSGCNT 

. MRKT tAREA . ♦TIME . »MKTC 

RETURN 

SDAT COMPLETION ROUTINE 


SD 
*1 


005367 
000207 


000206 


SDATC! 


DEC 
RETURN 


MSGCNT 





•TITLE DEMOFG 

.IDENT /VOS.OO/ 
' FOREGROUND DEMONSTRATION PROGRAM TO PRINT MESSAGE TD BACKGROUND^ THEN 
i QUEUE A MESSAGE EVERY 2 SECONDS FOR THE BACKGROUND TO RING THE BELL. 

.MCALL . SDATC. PRINTp.MRKTp.aSETf. SPND 

(PRINT INTRODUCTORY MESSAGE 
tSET ASIDE 100 ELEMENTS FOR MESSAGES 
pSET UP HKTIH FOR 2 SECONDS FROM NDU 
(SUSPEND THE FG TILL MKTIM SATISFIED 



p?0 MESSAGES QUEUED YET? 

pYES-ND SENSE OUEUEING ANOTHER 

iSEND MESSAGE TO BG 

(BUMP MESSAGE COUNTER 

(SET UP ANOTHER MKTIM FOR 2 SECONDS 

(RETURN FROM COMPLETION ROUTINE 



30 


000176 


106 


31 


000240 


123 


32 


000324 


105 


33 






34 






33 


000402 


000000 


36 






37 






38 


000404 


000000 


39 


000406 


000170 


40 






41 


000410 




42 






43 


000424 




44 






43 






46 


001424 





hsg: .ASCII 

.ASCII 
.ASCIZ 
■ EVEN 

MSGCNT : -UORD 



/FOREGROUND DEMONSTRATION PRDGRAM/<15><12> 

/SENDS A MESSAGE TD THE BACKGROUND PROGRAM ■DEMDBGV<13><12> 

/EVERY 2 SECONDS. TELLING IT TO RIND THE BELL./ 



(MESSAGE COUNTER 



area: 

BUFFER ! 



.BLKU 6 
.BLKU 400 



(TIME CONSTANT 

(HIGH ORDER 

(60 TICKS A SEC0ND>2 SECONDS 

(EMT ARGUMENT AREA 

(BUFFER FOR HE5SADES 



48 000000' 
DEMOFG MACRO V05.00 Saturday ( 
S^jmbol table 



.BLKU 
.END 



100. *10. 

START 



AREA 

BUFFER 
MKTC 



MKTCl 000132R 
MSD 000176R 
MSDCNT 000402R 



000410R 
000424R 
000062R 

000000 

005344 

: detected: 



**t Aeseriibler statistics 

Uork file reads: 

Work file writes! 

Size of work file: 9386 Uords ( 37 Paaes) 

Size of c TB pool: 1S616 Uords ( 61 PaSes) 

Operatlnd sustem: RT-11 



...VI 


1-9 


1-10 


1-17 


1-19 


...V2 


1-17 


1-17 


1-17* 


1-17 


AREA 


1-10 


1-17 


1-19 


1-41 


BUFFER 


1-17 


1-43* 






MKTC 


1-10 


1-15* 


-19 




MKTCl 


1-16 


1-19* 






HSG 


1-B 


1-30* 






MSGCNT 


1-lS 


1-ia* 


1-24* 


1-35 


QUEUE 


1-9 


1-46* 






SDATC 


1-17 


1-24* 






START 


1-B# 


1-48 






TIME 


1-10 


1-19 


-33* 




DEMOFG 


MACRO 


V05.00 Saturdaii 08- 


J3n-B3 


Cross r 


eferenc 


e table (CREF 


V05.00 


> 


...CHO 


1-9 








...CMl 


1-17 








...CM2 


1-10 


1-10 


l-IO 


1-17 


...CM4 


1-17 








...CHS 


1-9 


1-10 


-17 


1-19 


...CM6 


1-10 


1-19 






.MRKT 


1-6* 


1-10 


-19 




.PRINT 


1-6* 


1-8 






.QSET 


1-6* 


1-? 






.SDATC 


1-6* 


1-17 






.SPND 


1-6* 


1-11 







.LINK/FOREGROUND/MAP DEMOFG 
RT-11 LINK V08.00 Load Map 
DEMOFG. REL Title: DEMOFG Ii 



Section Addr S 


i=e Global 


Value 


Global Ualoe Glob 


. ADS. 000000 001000 = 256. 


uords 


RUiIpGBL.ABS.OUR] 


001000 005344 = 1394. 


words 


RU.IpLCL.RELpCON) 




START 


001000 




Transfer address 


= OOIOOOp Hiah 


limit = 


006342 = 1647. word 


.DIRECTORY «.OBJ 








oa-J3n-83 








ODT .OBJ 8 


22-0ct-82 


VDT 


OBJ 8 22-0ct-32 


UTHDLR.OBJ 9 


22-0ct-S2 


SYSLIB 


OBJ 46 22-0ct-B2 


ERROUT.OBJ IS 


22-Oct-82 


FORLIB 


OBJ 161 12-Mau~B0 


TEST . OBJ 1 


08-Jan-B3 


SUM 


OBJ 1 0B-Jan-B3 


DEMOFG. OBJ 1 


OB-Jan-83 


GRAPH 


OBJ 16 0B-J3n-83 


10 Fllesp 265 Blacks 






354 Free blocks 









.DELETE/NOOUERY GRAPH.* 
.DELETE/NOQUERY SUM.* 
.DELETE MATCH. MAP 
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Using Indirect Files 



SUMMARY: 
COMMANDS TO 
START AN 
INDIRECT FILE 



©filnam.COM 
Start the execution 
(filnam.COM). 



of the specified indirect file 



CTRL/C CTRL/C 

Halt execution of the indirect command file (use with cau- 
tion). 

DEASSIGN 

Remove logical device assignments. 



FILE MAINTENANCE 



Indirect file INDCT.COM contains commands that perform the 
appropriate copy and delete file maintenance operations. If the 
commands were not already part of the file, you would need to 
perform the appropriate file maintenance commands, in mon- 
itor command mode, after execution. 



REFERENCE 



RT-ll System User's Guide (AA-5279C-TC). Maynard, Mass.: Digital Equip- 
ment Corporation, 1983. 

A guide to the use of the RT-ll operating system. 
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CHAPTER 17 
ADVICE TO NEW USERS 



This manual introduces several common RT-11 functions but is 
neither exhaustive nor comprehensive in its treatment of 
system features, commands, or their options. For many users, 
this manual's description of these fundamental system opera- 
tions is sufficient; other users, however, may need or want fur- 
ther description of a programming language, extended system 
features, or the internal workings of the RT-11 system. These 
people should consult the references at the end of each chapter, 
the Guide to RT-11 Documentation, RT-11 System User's 
Guide, or the RT-11 System Utilities Manual. The Guide to 
RT—11 Documentation lists all RT-11-related material avail- 
able from DIGITAL; the RT-11 System User's Guide explains 
in detail monitor commands and command options; the RT-11 
System Utilities Manual describes the use of the RT-11 system 
utilities to develop programs, execute programs, and maintain 
files and storage media. 

The Introduction to RT—11 has shown you the right way to use 
some important system features and their associated monitor 
commands. This information, combined with the following basic 
guidelines for using the system, can help you to avoid pitfalls 
common to new users: 

® Do not become dependent on a single copy of a file. Always 
make a backup copy of any useful file. 

9 When using the editor, close files periodically to preserve 
edits. Divide long editing sessions into short ones so that 
user — or hardware — errors do not lose the efforts of long 
hours of editing. Close the file with the EX command and 
begin editing again from where you left off. 

® Avoid careless use of wildcard operations that manipulate 
multiple files. Use the /QUERY option to verify the operation 
to be performed. 

® When using indirect files or BATCH streams, avoid opera- 
tions that manipulate any of the system (.SYS) files or the 
indirect file in use. Check the indirect file carefully for errors 
before you use it. Once the command stream is initiated, you 
may be unable to detect and prevent possibly serious errors. 

9 If you run two jobs under the control of the foreground/back- 
ground monitor, be sure there is no conflict of nondirectory- 
structured devices (LP:, MT:, TT:) used by the two jobs. 
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USING THE 
HELP FILE 



HELP 



A HELP file containing information about the keyboard mon- 
itor commands and how to use them is distributed with the 
RT-11 system. A list of keyboard monitor commands and a de- 
scription of their functions can be displayed at the terminal by 
typing: 

.HELP »(EI 



To get a detailed description of the use of the HELP command 
itself, type only HELP. 

.HELPdSI 

The following information is displayed on your terminal. 



HELP 



Lists helpful information 



SYNTAX 

HELPC/opt ions ] C topicC sub top i o C ; i terns ....]... 1 ] 
or HELP » 



SEMANTIC 
HELP 

aua 
HELP 

pa r 
HELP 

top 
HELP 

spe 

HEL 

wh i 
HELP 

ass 
HELP 

the 
Mali 
Subt 

and 
I tern 



S 

♦ lis 
liable 

lists 
t) . 

t opi 
i c on 1 

t opi 
i f i 
P HELP 
oh t h i 

t opi 
00 i at e 

t opi 

5 pe i 
d topi 
opi OS 

"EXAM 
s are 



ts the items for which help is 
the HELP text (of which this is a 

lists information on the specific 
y . 

subtopic lists information on the 
subtopic only (for example) 

SEMANTICS lists the paragraph of 
5 text is a part). 

sub topi c : item lists only the text 
d With the specific item, 
/item lists the text associated with 
fie item under the subtopic OPTIONS. 
OS are the keyboard monitor commands, 
are "SYNTAX". "SEMANTICS". "OPTIONS" 
PLES". 
specific command options. 



OPTIONS 
PRINTER 

Prints the HELP text on the line printer 
TERMINAL (default) 

Types the HELP text on the terminal 



EXAMPLES 
HELP COPY 

HELP/PRINTER EXECUTE 

HELP PRINT OPTION:COPIES 

HELP COPY/BOOT/DEVICE 



Lists information about 
COPY command 
Prints info rmat ion 
about EXECUTE command 
Describes the COPIES 
option for PRINT 
Describes the listed 
options for COPY 



In the command syntax shown above, topic represents a specific 
keyboard monitor command about which you need information. 
The subtopic represents a specific category within a topic; the 
subtopics are syntax, semantics, options, and examples. The 
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item represents one of the members within the subtopic group. 
You can specify more than one item in the command line if you 
separate the items with a colon (:). 

The only two options you can use with the HELP command are 
/PRINTER and /TERMINAL. The option /PRINTER sends the 
help information to a printer if one is available. The option 
/TERMINAL (the default mode) sends the information to the 
terminal. 

To get all the information in the help file about the keyboard 
monitor command ASSIGN, type the following command: 

.HELP ASSIGN® 

You have used this command in examples in the other chapters. 
The following information is displayed at your terminal: 

ASSIGN Associates a losioal deuioe name with a 
physical device 

SYNTAX 

ASSIGN phys ical -deui ce-name 1 o Si oal -deu i ce-name 

SEMANTICS 

Physical-deuice-name is the RT-11 standard 
permanent name for the deuice. 

LoSioal-deu ice-name is one to three alphanumeric 
characters Ions with no interuenins spaces or tabs. 
The physical name and losical name must be 
separated by a space. 

OPTIONS 

Non e 

EXAMPLES 

ASSIGN RKl: DK : 



When you want specific information for a keyboard monitor 
command, such as the syntax, semantics, options, or examples, 
include that subtopic in the command. For example, the fol- 
lov/ing command lists all the options that are available for use 
with the DIRECTORY keyboard monitor command: 

.HELP DIRECTORY OPTIONS® 

If you need information only about a specific item in a list of 
options, type the item in the command line. 

.HELP DIRECTORY OPTIONS ; ORDEREB 

ORDERC icatesory] 

Orders the directory listins acoordins to the catesory 
specify! same as /SORT. CateScries are; 

NAME- orders alphabetically by file name 

TYPE- orders alphabetically by file type 

SIZE- orders by file size 

DATE- orders by creation date 

POSITION- orders by file position on the deuice 
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APPENDIX A 

MANUAL BOOTSTRAPPING OPERATIONS 



PDP-11 computers that do not have the automatic bootstrap- 
ping capability described in Chapter 2 require manual 
bootstrapping. This appendix's first section, Bootstrapping the 
System, provides information that you will need to bootstrap 
the system manually. Follow the procedure described in this 
section; you will be referred — if appropriate for your 
system — to one of the other sections, which describe using a 
pushbutton console to bootstrap, using a switch register console 
to bootstrap, and tj^jing the bootstrap. 



Once you have identified your hardware configuration, you are BOOTSTRAPPING 

ready to bootstrap the system. The purpose of the bootstrap jug SYSTEM 

procedure is to load and start the RT-11 monitor in computer 
memory, activating the RT-11 operating system for your use. 

1. Set the terminal to an on-line condition. 

2. Make sure that the computer power is on and that the com- 
puter is not already in use. Stop the computer, following 
one of two procedures: 

® If your operator's console has switches, set the switches to 
HALT, then. ENABLE. 

® If your operator's console has pushbuttons, locate the 
button labeled CNTRL; hold it down and push the button 
labeled HLT/SS; then release both. 

3. Place the system volume in device unit 0. Make sure that 
the system volume is write-protected (for all except RXOl or 
RX02 diskettes, v/hich are alv/ays v/rite-enabled). 

4. Place the storage volume in the device unit you identified 
for question 8 in the Hardware Configuration section of 
Chapter 2. Make sure that this volume is write-enabled. 

5. If your operator's console has pushbuttons, continue to step 
6. Otherwise, go to step 8. 

6. Locate the pushbutton labeled CNTRL, hold it down and 
push the button labeled BOOT. Check the terminal printer 
or screen. If there is no response, read the Using a Push- 
button Console to Bootstrap section of this appendix; other- 
wise, continue to step 7. 

7. Your terminal printer or screen should show several num- 
bers and then a dollar sign ($). 
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Type on the terminal keyboard the two-letter mnemonic 
that represents your system volume (from question 6 in the 
Hardware Configuration section^) followed by a carriage re- 
turn. Be sure to use the SHIFT key so that you type upper- 
case characters. For example, for RX02 diskette, tjrpe: 

*DYiSl 

Continue to step 11. 

8. Check your switch console. If it has a three-way dial labeled 
DC OFF, DC ON, and STAND BY, go to step 9. If it has 
three individual switches labeled DC ON/OFF, EN- 
ABLE/HALT, and LTC ON/OFF, go to step 10. If it has a 
row of switches across the entire console, read the Using a 
Switch Register Console to Bootstrap section of this appen- 
dix. 

9. Set the three-way dial to DC ON. Then locate the BOOT 
switch (to the left of the dial) and raise it. Go to step 11. 

10. Put all three switches in the up position; then move the DC 
ON/OFF switch down and up and check the terminal re- 
sponse. 

® If the terminal displays the dollar sign ($), type on the 
keyboard the two-letter mnemonic that represents your 
system volume (from question 6 in the Hardware Configu- 
ration section) followed by a carriage return. Be sure to 
use the SHIFT key so that you type uppercase characters. 
For example, for RX02 diskette, type: 

*DY(al) 

Continue to step 11. 

• Any other response indicates that you must tjrpe the boot- 
strap on the terminal keyboard. Read the Typing the 
Bootstrap on the Terminal Keyboard section of this ap- 
pendix. 

11. If your system has been successfully bootstrapped, a mes- 
sage like the following prints on the console terminal. 

RT-iiFB U05.XX (the xx's represent numbers that have 
significance only for DIGITAL'S soft- 
ware development; you can ignore 
these numbers) 



^The RK05 disk is an exception. Hardware bootstraps use DK, not RK, for 
RK05. 
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If the message indicating RT-llFB V05 does not appear, 
refer to Appendix B and read the section entitled Sugges- 
tions for Bootstrapping the System. 

The message indicates that the foreground/background 
monitor component of the RT-11 Version 5.0 operating 
system is active. Set the system volume to a write-enabled 
condition (for all except RXOl and RX02 diskettes, which 
are always write-enabled). 

You should now direct your attention to the console terminal, 
since system interaction continues on this device. Continue to 
Chapter 3. 



The bootstrap for your RT-11 computer system consists of a 
series of six-digit numbers that you must type on the terminal 
keyboard. First, obtain the bootstrap from the RT-11 Installa- 
tion Guide, and copy the numbers into the space below: 



TYPING THE 

BOOTSTRAP 

ON THE TERMINAL 

KEYBOARD 



Now, follow the instructions below to t3T)e, on your terminal 
keyboard, the bootstrap (if you make a mistake, type the DE- 
LETE key on the terminal keyboard, once for each typing error, 
and then type the correct digit[s]): 

1. Type 001000. 

2. Type slash (/). 

3. Type the first number in the bootstrap column. 

4. Type the LINE FEED key. 

5. Type the next number in the bootstrap column. 

6. Repeat steps 4 and 5 until you have typed all the numbers 
in the column. 

8. Type lOOOG. 

9. Continue to step 11 in the section entitled Bootstrapping 
the System in this appendix. 
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USING A 
PUSHBUTTON 
CONSOLE TO 
BOOTSTRAP 



If your computer has a pushbutton console similar to the one 
shown in Figure A-1, you can use the buttons to manually give 
the computer the information it needs to bootstrap the system. 



''•^^ 




Figure A-1 Pushbutton Console 



The bootstrap for your RT-11 computer system consists of a 
series of six-digit numbers that you must load into the com- 
puter using the pushbutton console. First, obtain the bootstrap 
of your system device from the RT-11 Installation Guide, and 
copy the numbers into the space provided below. If your system 
has a hardware bootstrap/ the bootstrap will consist of only two 
numbers, which you should copy into the left-hand space; other- 
wise, the bootstrap will consist of two columns of numbers la- 
beled Location and Contents, which you should copy into the 
right-hand space: 



Hardware Bootstrap 

Load Address = 
Start Address = 



Other Bootstraps 



To activate the hardware bootstrap, use the pushbuttons to set 
the numbers as described in the following steps (if you make a 
mistake, push the button labeled CLR, then reenter the 
number): 

1. Push the appropriate buttons for the load address (read the 
number from left to right). 

2. Push LAD. 

3. Push the appropriate buttons for the start address (read the 
number from left to right). 

4. Push the button labeled CNTRL, and, while holding it 
down, push the button labeled START. 

5. Continue to step 11 in the Bootstrapping the System section 
of this appendix. 



^A hardware bootstrap is bootstrapping information that is already in com- 
puter memory but that you must activate by entering a load address and a 
start address, each a six-digit number. 
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To activate other bootstraps, use the pushbuttons to set the 
numbers as described in the following steps (if you make a mis- 
take, push the button labeled CLR, then reenter the number): 

1. Push 1000 (read the number from left to right). 

2. Push LAD. 

3. Push the appropriate buttons for the first number in the 
Contents column (read the number from left to right). 

4. Push DEP; push CLR. 

5. Push the appropriate buttons for the next number in the 
Contents column (read the number from left to right). 

6. Repeat steps 4 and 5 until all numbers in the column have 
been used. 

7. Push 1000. 

8. Push LAD. 

9. Push the button labeled CNTRL, and, while holding it 
down, push the button labeled START. 

10. Continue to step 11 in the Bootstrapping the System section 
of this appendix. 



If your computer has a switch register console similar to the 
one shown in Figure A-2, you can use the switches to manually 
give the computer the bootstrapping information it needs to 
start the system. 



// 



1 1 '^ ■ 



\\ \ 

- ■ ; 
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Figure A-2 Switch Register Consoles 

Several switches on the console are spring-loaded. This means 
that the switch moves in only one direction and returns to its 
initial position after you use it. You must set the remaining 
switches either up or down as instructed. 
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The bootstrap for your RT-11 computer system consists of a 
series of six-digit numbers that you must load into the com- 
puter using the switch register console. First, obtain the boot- 
strap of your system device from the RT-11 Installation Guide, 
and copy the numbers into the space provided below. If your 
system has a hardware bootstrap/ the bootstrap consists of only 
two numbers, which you should copy into the left-hand space; 
otherwise, the bootstrap consists of two columns of numbers, 
labeled Location and Contents, which you should copy into the 
right-hand space: 

Hardware Bootstrap Other Bootstraps 

Load Address = 
Start Address = 

Next, convert the numbers in the column to binary numbers, 
using the conversion process shown in Table A-1. 

Table A-1 Binary Conversion 



Octal 




Binary 





= 


000 


1 


= 


001 


2 


= 


010 


3 


= 


oil 


4 


= 


100 


5 


= 


101 


6 


= 


110 


7 


= 


111 



For example, the number 173100 is converted to 001 111 Oil 
001 000 000. You set this 18-digit binary number into the 
switch register by placing each individual switch in an up posi- 
tion for a 1 or a down position for a 0. The number 173100 is set 
into the switch register as follows: 

lit t t t it! U t ii i i U 

The number 012700 is converted to 000 001 010 111 000 000 
and is set into the switch register as follows: 

III llA lAl AAA III III 

4,4,4, 4,4.1 4'InI' 111 nI'4'nI' ^ -l -l 



^A hardware bootstrap is bootstrapping information that is already in com- 
puter memory but that you must activate by entering a load address and a 
start address, each a six-digit number. 
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NOTE 



The switch register is the group of switches appearing on 
the left of the console. Your switch register may have 
only 16 switches rather than 18; in this case you can 
ignore the left-hand two digits of the binary number when 
you set the switches. 

To activate the hardware bootstrap: 

1. Set the switch register to the appropriate positions for the 
load address. 

2. Press the spring-loaded LOAD ADDR switch. 

3. Set the switch register to the appropriate positions for the 
start address. 

4. Press the spring-loaded START switch. 

5. Continue to step 11 in the Bootstrapping the System section 
of this appendix. 

To activate other bootstraps, set the numbers into the switch 
register using the following method: 

1. Set the switch register to the appropriate positions for the 
number 001000. 

2. Press the spring-loaded LOAD ADDR switch. 

3. Set the switch register to the appropriate positions for the 
first number in the Contents column. 

4. Press the spring-loaded DEP switch. 

5. Set the switch register to the appropriate positions for the 
next number in the Contents column. 

6. Repeat steps 4 and 5 until all the numbers in the column 
have been used. 

7. Set the switch register to the appropriate positions for the 
number 001000. 

8. Press the spring-loaded LOAD ADDR switch. 

9. Press the spring-loaded START switch. 

10. Continue to step 11 in the Bootstrapping the System section 
of this appendix. 
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APPENDIX B 

SELECTED SYSTEM TOPICS 



The remarks in this appendix cover a variety of topics that 
should prove helpful to you as you perform the demonstrations 
in the manual. Included, for example, are instructions for 
starting and stopping the system, alternate methods for per- 
forming some system operations, and directions for using the 
language volume. The sections are listed here in the order in 
which they are referenced from within the text of the manual. 



You can plan to take a break at the end of any individual 
chapter in this manual. If you intend to be away from the com- 
puter system for any length of time, you should halt the system 
and remove your system and storage volumes. 



STOPPING AND 

STARTING THE 

SYSTE!\^ 



Perform the following steps in order: 
1. Stop the computer. 



9 If your computer is a PDP-11/23-PLUS, lift the HALT 
toggle switch to the up position. 

® If your computer is a PDP-11/24 or a PDP-11/44, push 
the HALT/CONT/BOOT horizontal toggle switch to the 
HALT position. 

® If your computer operator's console has switches, press the 
HALT switch. 

® If your computer operator's console has pushbuttons, hold 
the CNTRL button down and push the HLT/SS button. 

2. Unload the system volume. Set the device unit to an off-line 
condition, and remove the system volume. 

3. Unload the storage volume. Set the device unit to an off- 
line condition, and remove the storage volume. 

A TD„~,^ ,„ ] „ ,„ „n i-^~, 4 1 1 t: i_j.-.. J. J. 1^_j. 

•*. ivciiiuvc aiiu. oavc axi. i/ci luiiieii aiiu line priiiut!!' uULpUL IISL- 

ings. 



Stopping the 
System 



Perform the following steps in order: 

1. Follow the bootstrap procedure, as described in Chapter 2 or 
Appendix A. 



Starting the 
System 
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2. Enter the current date and time-of-day (Chapter 4). 

3. Make any necessary logical device assignments. For the ex- 
amples in this manual, you must assign the logical name 
VOL: to your storage volume (Chapter 4). 



THE SYSTEM STOPS 
UNEXPECTEDLY 



If for any reason the computer system stops unexpectedly, re- 
quest help from an experienced user if possible. The problem 
may be accompanied by an error message (see the RT-11 
System Message Manual); the problem may be in the hardware, 
in the software, or in your program. Once the problem is diag- 
nosed and corrected, try to bootstrap the system again. 



SUGGESTIONS FOR 
BOOTSTRAPPING 
THE SYSTEM 



You must be able to bootstrap your RT-11 system before you 
can perform the demonstrations in this manual. Three common 
bootstrapping problems and suggestions for their correction 
follow. 

1. You cannot remember how to bootstrap your system. 

Ask an experienced RT-11 user to help you. If no one is 
available, read the bootstrapping instructions in the RT-11 
Automatic Installation Booklet or the RT-11 Installation 
Guide. If necessary consult the appropriate hardware man- 
uals for the devices that are part of your system; these man- 
uals provide a description of the device and operating proce- 
dures. Then try the bootstrap procedures again. 

2. You have followed the bootstrapping instructions correctly, 
but your system printed a message other than what you 
expected. 

a. The message can be one of the following: 

?BOOT-F-No boot on uoluwe 
?BODT-U-Conf liotins SYSGEN options 
?BDOT-U-Handle r file not found 
?BOOT-U-Insuf f icient memo r-/ 
7B00T-U-I/0 error 
?BODT-U-Monito r file not found 
?BOOT-U-No KTll 
?BOOT-U-Swap file too small 
7B00T-U-SWAP.SYS not found 
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?BOOT-W-Error read in 3 handler 
?BOOT-W-Inyalid or missing TTiSYS 

These are bootstrap error messages, indicating that a 
problem in the system is preventing bootstrapping. 
These eleven messages are fully explained in the RT-11 
System Message Manual, but you should not try to cor- 
rect the problem yourself if an experienced user is avail- 
able to help. 

b. The message can be one of the following: 

RT-llSJ V05-XX 
RT-llXM M05-XX 

These indicate that a valid RT-11 V5 monitor program 
has been bootstrapped, but it is not the one you should 
be using. Reboot the correct monitor program by typing 
the following commands on the terminal: 

.BOOK® 

Deyice or file? RTl IFB.SYS® 

c. Any other message indicates that an old version of 
RT-11 (VI, V2, V2B, V2C, V3, V3B, or V4) has been 
bootstrapped. Only Version 5 of RT-11 can be used to 
perform the demonstrations in this manual. 

3. You followed the bootstrapping instructions correctly, but 
nothing happened, that is, there was no terminal response 
at all. 

Repeat the bootstrap procedure from the beginning. Before 
you begin, make sure that the system volume is properly 
mounted in device unit 0. The computer should be on but 
not running (the light labeled RUN should not be on); if the 
computer is running, stop it as described above. Make sure 
that the terminal is on line and that its baud rate is set to 
300. If you are using a display terminal, make sure that the 
screen is bright enough for you to read. If your terminal 
uses a paper printer, make sure that the paper is properly 
loaded. 



A copy of the RT-11 Version 5 system volume, as distributed by BACKING UP THE 

DIGITAL, should be stored away for safekeeping as a backup SYSTEM VOLUME 

copy. If you do not have a backup copy of your system volume, 
create one before you continue. Manual backup instructions are 
in the RT-11 Installation Guide; an experienced user should 
perform the backup operation. 
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DIRECTORY- VS 
NONDIRECTORY- 
STRUCTURED 
VOLUMES 



Storage volumes are called file-structured volumes because 
they are capable of physically storing files. These volumes can 
be further categorized as directory-structured and nondirectory- 
structured; the distinction is based on the method of directory 
information storage, collection, and printing. 

Directory information includes file names and types, dates of 
creation, and (in most cases) file lengths. When you type the 
DIRECTORY command, this directory information prints on 
your terminal. Volumes such as disks and diskettes keep this 
information in a single place at the beginning of the volume. 
Each time you add or delete a file, the directory information is 
updated. These volumes, which maintain a directory separately 
from the files described, are said to be directory-structured. 
Magtape volumes, on the other hand, do not keep directory in- 
formation in any single, separate place on the tape but rather 
with each individual file. For these volumes the directory infor- 
mation is collected for printing as each file is encountered 
during a sequential reading of all files on the tape. Thus, these 
volumes are said to be nondirectory-structured. 

You can list the directory from either t3T)e of volume in com- 
plete or abbreviated format. Complete directories include the 
file name, file type, file length, and date of creation (if the 
DATE command was used before the file's creation). For most 
volumes, the directory format is as follows: 



8-Jan-83 
FILE .TYP 



:i-Feb-BC 



Abbreviated directories include only the file name and file tj^je, 
and are printed in five columns. For more information about 
directory-structured and nondirectory-structured volumes, see 
the RT-11 System User's Guide. 



ALTERNATE 
RENAME 
OPERATION FOR 
MAGTAPE USERS 



You cannot use the RENAME monitor command if your volume 
is a magtape because of the magtape's sequential (nondirectory- 
structured) nature. To perform the RENAME operation, you 
must first copy the file, using the new file name, and then de- 
lete the old file. 

TPnv oypTnnlo fr> ^Vipncro i-Via -noTviQ <-vP fVia TIT} ATiTI n^\\jri «1« 1^ 

vi^uv^vx vrxx ^ w«.x kjv\^x(^^%^ TWXt^xxxv^, v\j V^XVXXJ. J.X.X' \^X1<, XXXOLl U1CIA~C7 CL 

copy of GRAPH.TWO, giving the new file the name 
GRAPH.FOR. 



Long Command Format 

.COPY® 

From? VOL: GRAPH. TWO®) 

To ? GRAPH. FOF 
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.COPY yOLsGRAPH.TWO GRAPH. FD 
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You now have two copies of the GRAPH file. Delete the one not 
wanted, using the monitor DELETE command. (This command 
is described in Chapter 7 in the section entitled File Delete 
Operations.) 

Long Command Format 

.DELETEdS) 

Files? VOL! GRAPH. TWOdSl 

Short Command Format 

.DELETE MOL; GRAPH. TWO® 

A single copy of GRAPH.FOR now resides on your system 
volume. Copy the file onto your storage volume. 

Long Command Format 

.COPYH 

From? GRAPH.FOR® 

To ? UOLzGRAPH.FOR® 

Short Command Format 

.COPY GRAPH.FOR MOL : GRAPH . FOR® 

Delete the original file. 
Long Command Format 

.DELETE® 

Files? GRAPH.FOR® 

Short Command Format 

.DELETE GRAPH.FOR® 

The combined effect of these four commands is to "rename" 
GRAPH.TWO to GRAPH.FOR. 



The FORTRAN/BASIC language volume was created during 
system installation specifically for your use with this manual. 
This volume contains the FORTRAN IV and/or BASIC-11 lan- 
guage processors and the monitor files required to use these 
language processors. Before you can perform the FORTRAN IV 
or BASIC-11 demonstrations, you must substitute this 



USING THE 

FORTRAN/BASIC 

LANGUAGE VOLUME 
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FORTRAN/BASIC language volume for the system volume cur- 
rently mounted in device unit 0. The language volume then 
serves as the system volume during the course of the FOR- 
TRAN IV and BASIC-11 demonstrations. 

Make sure that no system operations are in progress (the mon- 
itor prompt, the period, should appear at the left margin of the 
terminal printer), and stop the system (see Stopping and 
Starting the System, this appendix). Now remove the system 
volume currently loaded in device unit 0, and insert and write- 
protect the language volume. Bootstrap the system (see Stop- 
ping and Starting the System, this appendix). The following 
monitor message should appear: 



RT-llFB 



M05.XK 



Write-enable the volume. Then enter the current date and 
time-of-day, and assign the logical name VOL: to your storage 
volume, just as you did in Chapter 4. When you have done this, 
you are ready to run the language demonstration. Return to the 
main text of this manual. 



SUBSTITUTING 
VOLUMES 
DURING 
OPERATIONS 



Users of FORTRAN IV on diskette who have the FORTRAN IV 
language processor on a volume apart from their system 
volume must occasionally copy files and substitute volumes. 
These operations are necessary when files needed are not stored 
on a currently mounted volume. The appropriate volume, con- 
taining needed files, must be substituted for a currently 
mounted volume. If the volume to be dismounted contains nec- 
essary files, these files must be copied to a volume that will 
remain mounted. 

For example, before you can compile the FORTRAN IV file 
THIRD.FOR, you must substitute the language volume con- 
taining the FORTRAN IV compiler for the system volume cur- 
rently loaded in device unit 0. First, however, you must copy 
the file THIRD.FOR to your storage volume so that it will be 
available for use. 



Long Command Format 

.COPY® 

From? THIRD.FOR® 

To ? UOL:THIRD.FOR@ai 



Short Command Format 

.COPY THIRD.FOR VOLiTHIRD.FO 
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When the copy operation is finished, stop the system, remove 
the system volume currently loaded in unit 0, and insert and 
write-protect the language volume. See Stopping and Starting 
the System (this appendix) if necessary. The following message 
appears when the language volume is bootstrapped. 

RT-llFB yOS.xx 

Write-enable the volume. Then enter the current date and 
time-of-day, and assign logical name VOL: to your storage 
volume, as described in Chapter 4. 

Next, compile the FORTRAN IV program THIRD.FOR, which 
is now on VOL:. 

Long Command Format 



.FORTRAh 

Files? UOLsTHIRD.FOREEl 

PUTSTR 

Short Command Format 

.FORTRAN MOLiTHIRDED 
PUTBTR 

The FORTRAN command causes the object module to be cre- 
ated on the default storage volume, which is presently the 
system volume (that is, the language volume). Any errors that 
occur during the compile operation indicate that the source file, 
THIRD.FOR, contains typographical errors. You must edit the 
file to correct any errors, recompile, and then copy the file to 
VOL:. Once you have an object module compiled without error 
and stored on VOL:, reload the main system volume in unit 0. 
Follow the directions in Stopping and Starting the System. 
Bootstrap and write-enable the system volume, enter the cur- 
rent date and time-of-day, and assign the logical name VOL: to 
your storage volume. 

Now copy the object module on VOL: back to the system 
volume. 

Long Command Format 

.COPY®) 

Prow? VOLsTHIRD OBJEl 

To 



Short Command Format 

.COPY yOLsTHIRD.OBJ TH IRD . OB JUS 

Continue to Chapter 13, to the section entitled Building the 
Object Library. 
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USING THE The LINK volume was created during system installation for 

LINK VOLUME you to use with this manual. This volume contains the linker, 

LINK.SAV, and the system subroutine library, SYSLIB.OBJ. 
Before you can perform the linking demonstrations in Chapters 
9 and 12, you must substitute this LINK volume for your cur- 
rent system volume, which is mounted in device unit 0. The 
LINK volume then serves as the system volume during the 
course of the linking demonstration. 

First, transfer the object file you need to link to the storage 
volume. 

Long Command Format 

.COPY® 

From? GRAPH, OBJ® 

To ? yOL:GRAPH.OBJ@ai 

Short Command Format 

.COPY GRAPH. OBJ MOL : GRAPH . OB J® 

Make sure that no system operations are in progress (the mon- 
itor prompt, the period, should appear at the left margin of the 
terminal printer), and stop the system (see Stopping and 
Starting the System, this appendix). Now remove the system 
volume currently loaded in device unit 0, and insert and write- 
protect the LINK volume. Bootstrap the system. The following 
monitor message should appear: 

RT-llFB yOS.xx 

Write-enable the volume. Then enter the current date and time, 
and assign the logical name VOL: to your storage volume, just 
as you did in Chapter 4. 

Finally, transfer the object file from the storage volume to the 
system volume. 

Long Command Format 

.COPY® 

From? MOL; GRAPH. OBJ® 

To ? GRAPH. OB. 



Short Command Format 

.COPY yOL:GRAPH.OBJ GRAPH. OBJ® 

When you have done this, you are ready to run the linking 
demonstration. Return to the main text of this manual. 
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Follow the file maintenance operations outlined in this section 
if you substituted both a FORTRAN IV language volume and a 
LINK volume to perform the demonstrations in Chapter 9. 

First, mount the FORTRAN IV language volume in device unit 
0. If you do not remember how to do this, follow the instructions 
in the section of this appendix entitled Using the FORTRAN/ 
BASIC Language Volume. 

Next, obtain a directory listing of all the files on your FOR- 
TRAN IV volume that have the name GRAPH, regardless of 
file type; these files were generated as a result of the exercises 
in Chapter 9. 

Long and Short Command Formats 



•DIRECTORY GRAPH.*® 










8-Jan-83 










GRAPH ,BAK 2 08-Jari-B3 


GRAPH 


.FOR 


2 


08-Jan-83 


GRAPH ,OBJ 16 08-Jan-B3 


GRAPH 


.LST 


8 


08 -J an -83 


a Files > 28 BlooKs 










48 Free blocks 











Since you have corrected errors in the source file GRAPH.FOR, 
the version on your storage volume is obsolete. Transfer the 
corrected GRAPH.FOR file from your system volume to VOL:, 
thus replacing the obsolete file. 
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FORTRAN/LINK 
FILE MAINTENANCE 



Long Command Format 



•COPY® 

From? GRAPH.FOR® 

To ? VOLsGRAPH.FO 



Short Command Format 

•COPY GRAPH.FOR MOL:GRAPH.FO 



Next, transfer GRA.PH.LST to your storage volume. This en- 
ables you to examine the listing without having to recompile 
the program. 



Long Command Format 

• COPY® 

From? GRAPH. LST® 

To ? MOL:GRAPH.LST® 



Short Command Format 

•COPY GRAPH. LST VOLsGRAPH.LS 



Once you have transferred all valuable files to your storage 
volume, delete the unnecessary files from the system volume. 



B-9 



Selected System Topics 



Long Command Format 

.DELETEESI 
Files? GRAPH,*® 

Files deleted: 
DK. GRAPH. BAK ? YE) 
DK. GRAPH. FOR ? Y(aD 
DK. GRAPH. OBJ ? Y® 
DK. GRAPH. LST ' 



Short Command Format 

.DELETE GRAPH,*® 
Files deleted! 
DK. GRAPH. BAK ? YdH 
DK. GRAPH. FOR ? Y® 
DK, GRAPH, OB J ? Y® 
DK, GRAPH, LST ? YEH 

Make sure that no system operations are in progress (the mon- 
itor prompt, the period, should appear at the left margin of the 
terminal printer), and stop the system (see Stopping and 
Starting the System, this appendix). Now remove the system 
volume currently loaded in device unit 0, and insert and write- 
protect the LINK volume. Bootstrap the system (see Stopping 
and Starting the System, this appendix). The following monitor 
message should appear: 

RT-llFB M05.XX 

Write-enable the volume. Then enter the current date and time, 
and assign the logical name VOL: to your storage volume, just 
as you did in Chapter 4. 

Obtain a directory of all files on the system volume that have 
the name GRAPH, regardless of file tj^e; these files were cre- 
ated as a result of the linking demonstrations in Chapter 9. 

Long and Short Command Formats 

.DIRECTORY GRAPH.*® 

8-Ja)-i-B3 
GRAPH .OBJ la 08-Jan-83 GRAPH .SAW 19 08-Jan-83 

2 Filest 33 Blocks 

80 Free blocKs 

Transfer GRAPH. SAV to your storage volume. Because 
GRAPH. SAV is an executable file, you can run the program 
without relinking it. 

Long Command Format 

.COPY® 

From? GRAPH, SAV® 

To ? MOLsGRAPH.SAy® 
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Short Command Format 

.COPY GRAPH. SAV VOL s GRAPH . SAy® 

Next, delete the unnecessary files from your system volume. 
Long Command Format 

.DELETEdSl 

Files? GRAPH.DBJ»GRAPH.SAM(al) 

Short Command Format 

.DELETE GRAPH. OBJ .GRAPH. SAU® 

Finally, list the up-to-date directory of your storage volume so 
that you can see its current status. 

.DIRECTORY MOL:® 

Leave the LINK volume mounted in device unit 0, and proceed 
to Chapter 12, Linking Object Programs. 
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Absolute address 



The binary number that is assigned as the address of a 
physical memory storage location. 

Absolute section 

The portion of a program in which the programmer has 
specified physical memory locations of data items. 

Access time 

The interval between the instant at which data is re- 
quested from or for a storage device and the instant at 
which the data actually begins moving to or from the 
device. 

ADC (Analog to Digital Converter) 

A circuit that converts analog (voltage) signals to binary 
data. 

Address 

A label, name, or number that designates a location in 
memory where information is stored. 

Algorithm 

A prescribed set of well-defined rules or processes for the 
solution of a problem in a finite number of steps. 

Alphanumeric 

The subset of ASCII characters including the 26 alpha- 
betic characters and the 10 numeric characters. 

ANSI 

American National Standards Institute. 

Application program (or package) 

A program that performs a function specific to the needs 
of a particular end-user or class of end-users. An applica- 
tion program can be any program that is not part of the 
basic operating system. 

Argument 

A variable or constant value supplied with a command 
that controls the command's action, specifically its loca- 
tion, direction, or range. 

Array 

An ordered arrangement of subscripted variables. 



Glossary-1 



Glossary 

ASCII 



The American Standard Code for Information Inter- 
change; a standard code consisting of eight-bit coded 
characters for upper- and lower-case letters, numbers, 
punctuation, and special communication control charac- 
ters. 

Assembler 

A program that translates symbolic source code into ma- 
chine instructions. This program replaces symbolic oper- 
ation codes with binary operation codes and symbolic 
addresses with absolute or relocatable addresses. 

Assembly language 

A symbolic programming language that can be trans- 
lated directly into machine language instructions and is 
specific to a given type of control processing unit. 

Assembly listing 

A listing, produced by an assembler, that shows the 
symbolic code written by a programmer next to a repre- 
sentation of the actual machine instructions generated. 

Asynchronous 

The type of operation that is triggered by another event, 
as opposed to synchronous, or occurring at set time in- 
tervals. 

Background program 

A program that runs at a low priority, that is, when a 
higher priority (foreground) program is not using system 
resources. 

Backup file 

A copy of a file, created as a precaution against loss of 
the primary file. 

Base address 

An address used as the basis for computing the value of 
some other relative address; the address of the first loca- 
tion of a program or data area. 

BASIC-1 1 (Beginner's All-purpose Symbolic Instruction Code) 

An interactive, algebraic computer language that com- 
bines English words and decimal numbers. It is a widely 
available, standardized, simple beginner's language ca- 
pable of handling industry and business applications. 

Batch processing 

A processing method in which programs are run consec- 
utively without operator intervention. 
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Baud 

A unit of measurement of transmission speed; bits per 
second. 

Binary 

The number system with a base of two; used by the in- 
ternal logic of all digital computers. 

Binary code 

A code that uses two distinct characters, usually the 
numbers and 1. 



Bit 



A binary digit. The smallest unit of information in a 
binary system of notation. It corresponds to a 1 or and 
to one digit position in a physical memory word. 

Block 

A group of physically adjacent words or bytes of a size 
that is specific to a device. For input/output operations, 
the smallest addressable unit on a mass storage device. 

Bootstrap 

A technique or routine whose first instructions are suffi- 
cient to start a system of programs that bring an opera- 
ting system into memory. 

BOT (Beginning Of Tape) 

A reflective marker that is applied to the backside of 
magtape and identifies the beginning of the magtape's 
recordable surface. 

Bottom address 

The lowest memory address into which a program is 
loaded. 

Breakpoint 

A location at which program operation is suspended to 
allow operator investigation. 

Buffer 

A storage area used to temporarily hold information 
being transferred between two devices or between a de- 
vice and memory. A buffer is often a special register or a 
designated area of memory. 

Bug 

A flaw in the design or implementation of a program; a 
problem that can cause erroneous results. 
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Bus 



A flat, flexible cable consisting of many transmission 
lines, or wires. It interconnects computer system compo- 
nents to provide communication paths for addresses, 
data, and control information. 

Byte 

The smallest memory-addressable unit of information. 
In a PDP-11 computer system, a byte is equivalent to 
eight bits. 

Call 

A transfer from one part of a program to another with 
the ability to return to the original program at the point 
of the call. 

Calling sequence 

A specified arrangement of the instructions and data 
necessary to pass parameters and control to a given sub- 
routine. 

Centra! processing unit (CPU) 

A hardware unit of a computer that includes main 
memory and the registers and circuits that control the 
interpretation and execution of instructions. 

Character 

A single letter, numeral, or symbol used to represent 
information. 

Character pointer 

The place where the next character typed will be en- 
tered. During editing, the character pointer indicates 
the place in an ASCII text file where the next character 
typed will be entered into the file. 



Clear 



To delete the contents of a storage location by replacing 
the contents, usually with Os or spaces. 



Clock 



Code 



Mi. \A.G V iv/C^ vv xi/xj.x±x Ci. V'\/xj.xi/(.«.u\>x tojf tsuv-xxx vxxa,v x\.^c:;L/o UXXXXO. 

counts pulses, measures frequency, or generates regular 
periodic signals for synchronization. 



A system of symbols used to represent data or instruc- 
tions that are executed by a computer. 
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Coding 

The writing of instructions for a computer, using a 
system of symbols that is meaningful to a computer, an 
assembler, a compiler, or a language processor. 

Command 

A word, mnemonic, or character that, by virtue of its 
syntax in an input line, causes a computer system to 
perform a predefined operation. 

Command language 

The vocabulary used by a program or set of programs 
that directs the computer system to perform predefined 
operations. 

Command language interpreter 

The program that translates a predefined set of com- 
mands into instructions that a computer system can in- 
terpret. 

Command string 

A line of input entered into a computer system that gen- 
erally includes a command, one or more file specifica- 
tions, and optional qualifiers. 

Compile 

To produce binary code from the symbolic instructions of 
a high-level source language. 

Compiler 

A program that translates a high-level source language 
into machine instructions. 

Computer 

A machine that can be programmed to execute a set of 
instructions. 

Computer program 

A plan or routine for solving a problem on a computer. 

Computer system 

X A. V«.(.«.UI.4. k/X vr^/V/t^taj-J-JL^ tJJtJV\^J.X± UJ.J.(.4.U V/\^J.J.k^Xk3 VO V^JL J.J.CAX V4. TV CAJL O \AO~ 



vices, software programs, and documentation that de- 
scribes the operation of the system. 



Concatenation 



The joining of two or more strings of characters to pro- 
duce a single string. 
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Conditional assembly 

The assembly of certain parts of a symbolic program 
that occurs only when certain conditions are met during 
the assembly process. 

Configuration 

A selection of hardware devices, software routines, or 
programs that function together. 

Console terminal 

A keyboard terminal that acts as the primary interface 
between the computer operator and the computer 
system. The console terminal is used to initiate and di- 
rect system operations by running software on the com- 
puter. 

Constant 

A value that remains the same throughout a distinct 
operation. (Compare with Variable.) 

Context switching 

The saving of key registers and other memory areas be- 
fore switching between jobs with different modes of exe- 
cution. An example of context switching is the use of 
foreground/background programming. 

Conversational 

See Interactive. 



CPU 



See Central processing unit. 



Crash 



A hardware crash is the failure of a particular device to 
operate; the operation of an entire computer system may 
be affected. A software crash is the result of an opera- 
ting system malfunctioning; the system's protection 
mechanisms may have failed or the software may not 
have executed correctly. 



Create 

nn„ „„„« ^j-„ j„4-„ 4-^ ] „i ^ £:i„ ^ i.i-_ x: j. i.^ 

±\j upcii, wxitc uai/ci LL>, aiiu. ciuBC a iiic iui biic iirsu tiiiit:. 

Cross-reference listing 

A printed listing that identifies all references in a pro- 
gram to each specific symbol in a program. It includes a 
list of all the symbols used in a source program and the 
statements where the symbols are defined or used. 
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Current location counter 

A counter kept by an assembler to determine the ad- 
dress assigned to an instruction or constant being as- 
sembled. 

Data 

A term used to denote facts, numbers, letters, and sym- 
bols. Data are the basic elements of information that can 
be processed by a computer. 

Data base 

An organized collection of interrelated data items that 
allow one or more applications to process the items, 
while disregarding physical storage locations. 

Data collection 

To bring data from one or more locations to a central 
location for eventual processing. 

Debug 

To detect, locate, and correct coding or logic errors in a 
computer program. 

Default 

The value of an argument, operand, or field assumed by 
a program if not specifically supplied by the user. 

Define 

To assign a value to a variable or constant. 

Delimiter 

A character that separates, terminates, or organizes ele- 
ments of a character string, statement, or program. 

Device 

A hardware unit such as an I/O peripheral, magnetic 
tape drive, or line printer. 

Device control unit 

A hardware unit that electronically supervises one or 
more of the same type of devices. It acts as the link 
between the computer and the I/O devices. 

Device handler 

A routine that services and controls the hardware activi- 
ties of an I/O device. 

Device independence 

The ability to program I/O operations independently of 
the device for which the I/O is intended. 
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Device name 



A unique name that identifies each device unit on a 
system. It consists of a two-letter device mnemonic fol- 
lowed by an optional device unit number and a colon. 
For example, the common device name for RL02 disk 
drive unit 1 is DLl:. 

Device unit 

One of a set of similar peripheral devices. An example of 
a device unit is disk unit 0. It may be used synony- 
mously with volume. 

Diagnostics 

A set of procedures used to detect and isolate malfunc- 



Digit 



tions and mistakes. 

A character used to represent one of the non-negative 
integers smaller than the radix (for example, in decimal 
notation, one of the characters to 9; in octal notation, 
one of the characters to 7; in binary notation, one of 
the characters and 1). 

Direct access 

See Random access. 

Directive 

Assembler directives are mnemonics in an assembly lan- 
guage source program that are recognized by the assem- 
bler as commands to control a specific assembly process. 

Directory 

A file in the form of a table containing the names of and 
pointers to files on a mass storage volume. 

Directory-structured 

A storage volume is directory structured if the directory 
at the beginning of the volume contains information (file 
name, file tj^e, length, and date-of-creation) about all 
the files on the volume. Such volumes include all disks, 
diskettes, and DECtapes. 

Disl( device 

An auxiliary storage device on which information can be 
read or written. 

Dispiay 

A peripheral device used to represent data graphically; 
normally refers to some type of cathode-ray tube system. 
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Downtime 



Echo 



Edit 



The time interval during which a device or system is 
inoperative. 



The printing of characters tj^jed by the programmer on 
an I/O device such as a terminal. 



To arrange and/or modify the format of data; for ex- 
ample, to insert or delete characters. 



Editor 

A program that allows the user to enter text into the 
computer and edit it. Editors are language-independent 
and will edit anjrthing in character representation. 

Effective address 

The address used in the execution of a computer instruc- 
tion. 

Emulator 

A hardware device that permits a program written for a 
specific computer system to be run on a different type of 
computer system. 

Entry point 

A location in a subroutine to which program control is 
transferred when the subroutine is called. 

EOT (End Of Tape) 

A reflective marker applied to the backside of magtape, 
which precedes the end of the reel. 



Error 



Any discrepancy between a computed, observed, or 
measured quantity and the specified value or condition. 



Execute 



To perform an instruction or run a program on the com- 






Expression 

A combination of operands and operators that can be 
evaluated to a distinct result by a computing system. 

Extension 

The synonym used for file type. 
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External storage 

A storage medium other than main memory, for ex- 
ample, a disk or tape. 



Field 



A specified area of a record used for a particular cate- 
gory of data. 



FIFO (First In/First Out) 

A data manipulation method in which the first item 
stored is the first item processed. 



File 



A logical collection of data that is treated as a unit, occu- 
pies one or more blocks on a mass storage volume, and 
has an associated file name and type. 



File maintenance 



The activity of keeping a mass storage volume and its 
directory up to date by adding, changing, or deleting 
files. 

File name 

The alphanumeric character string assigned by a user to 
identify a file. It can be read by both an operating 
system and a user. A file name has a fixed maximum 
length that is system-dependent. (The maximum length 
in an RT-11 operating system is six characters, the first 
of which must be alphabetic. Spaces are not allowed.) 

File specification 

A name that uniquely identifies a file maintained in any 
operating system. A file specification generally consists 
of at least three components: a device name, a file name, 
and a file type. 

File-Structured device 

A device on which data is organized into files. The de- 
vice usually contains a directory of the files stored on 
the volume. (For example, a disk is a file-structured de- 
vice, but a line printer is not.) 

File type 

The alphanumeric character string assigned to a file ei- 
ther by an operating system or a user. It can be read by 
both the operating system and the user. System-recog- 
nizable file types are used to identify files having the 
same format or type. If present in a file specification, a 
file type follows the file name in a file specification, sep- 
arated from the file name by a period. A file type has a 
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fixed maximum length that is system-dependent. The 
maximum in an RT-11 operating system is three char- 
acters, not including any spaces and excluding the pre- 
ceding period. 

Flag 

A variable or register used to record the status of a pro- 
gram or device; the detection of errors by a translating 
program. 

Floating point 

A number system in which the position of the radix 
point is indicated by the exponent part of a number and 
another part represents the significant digits or frac- 
tional portion of a number (for example, 5.39 X 10^ — 
Decimal; 137.3 X 8* — Octal; 101.10 X 2'' — Binary). 

Flowchart 

A graphical representation for the definition, analysis, 
or solution of a problem, in which symbols are used to 
represent operations, data, flow, and equipment. 

Foreground 

The area in memory designated for use by a high- 
priority program. The program that gains the use of ma- 
chine facilities immediately upon request. 

FORTRAN IV (FORmula TRANslation) 

A problem-oriented language designed to permit scien- 
tists and engineers to express mathematical operations 
in a form with which they are familiar. It is also used in 
a variety of applications, including process control, in- 
formation retrieval, and commercial data processing. 

y Full duplex 

In communication, pertaining to a simultaneous, two- 
way, independent, asynchronous transmission. 

Function 

An algorithm, accessible by name and contained in the 
system software, that performs commonly used opera- 
tions. For fiXamnle the snnn-ro y-nni- f<Qlr.nlQ+ir>T, f,-.-^r^i-i — 

General register 

One of eight 16-bit internal registers in the PDP-11 
computer. These are used for temporary storage of data. 



Global 



A value defined in one program module and used in 
others. Globals are often referred to as entry points in 
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Interrupt vector 

Two words containing the address of an interrupt ser- 
vice routine and the processor state at which that rou- 
tine is to execute. 

Iteration 

Repetition of a group of instructions. 



Job 



Label 



A group of data and control statements that does a unit 
of work. A program and all of its related subroutines, 
data, and control statements is an example; also, a batch 
control file. 



One or more characters used to identify a source lan- 
guage statement or line. 



Latency 

The time from the initiation of a transfer operation to 
the beginning of actual transfer; that is, verification 
plus search time. The delay while waiting for a rotating 
memory to reach a given location. 

Library 

A file containing one or more macro definitions or one or 
more relocatable object modules that are routines that 
can be incorporated into other programs. 

LIFO (Last In/First Out) 

A data manipulation method in which the last item 
stored is the first item processed; a push-down stack. 

Light pen 

A device, resembling a pencil or stylus, that can detect a 
fluorescent cathode-ray tube (CRT) screen. The pen is 
used to input information to a CRT display system. 

Linkage 

The code that connects two separately coded routines 
and passes values and/or control between them. 

Linked file 

A file whose blocks are joined together by references 
rather than by consecutive locations. 



Linker 



A program that combines many relocatable object mod- 
ules into an executable module. It satisfies global refer- 
ences and combines program sections. 



Glossary-14 



Glossary 



Listing 

The printed copy generated by a line printer or terminal. 

Load 

To store a program or data in memory. To place a vol- 
ume on a device unit and put the unit on line. 

Load map 

A table, produced by a linker, that provides information 
about a load module's characteristics; for example, the 
transfer address, the global symbol values, and the low 
and high limits of the relocatable code. 

Load moduie 

A program in a format that is ready for loading and 
executing. 



Location 



An address in storage or memory where a unit of data or 
an instruction can be stored. 

Locked 

Pertaining to routines in memory that presently cannot 
be swapped or transferred. 

Logical device name 

An alphanumeric name assigned by the user to repre- 
sent a physical device. The name can then be used syn- 
onymously with the physical device name in all refer- 
ences to the device. Logical device names are used in 
device-independent systems to enable a program to refer 
to a logical device name assigned to a physical device at 
run-time. 

Loop 

A sequence of instructions that is executed repeatedly 
until a terminal condition prevails. 

Low-order byte 

The least significant byte in a word. The low-order byte 
occupies bit positions through 7 in a PDP-11 word and 
is always an even address. 

Macliine language 

The language used by the computer when performing 
operations. 



Macro 



An instruction in a source language that is equivalent to 
a specified sequence of assembler instructions, or a com- 
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mand in a command language that is equivalent to a 

specified sequence of commands. 

) 
Main program 

The module of a program that contains the instructions 
at which program execution begins. The main program 
usually exercises primary control over the operations 
performed; it also calls subroutines or subprograms to 
perform specific functions. 

Mask 

A combination of bits that is used to manipulate selected 
portions of any word, character, byte, or register while 
retaining other parts for use. 

Mass storage 

Pertaining to a device that can store large amounts of 

data that are readily accessible to the computer. ) 

Matrix 

A rectangular array of elements. Any matrix can be con- 
sidered an array. 

Memory 

Any form of data storage, including main memory and 
mass storage, in which data can be read and written. 
Memory usually refers to main memory. ' 

Memory image 

A replication of the contents of a portion of memory, 
usually in a file. 

Mnemonic 

An alphabetic easy-to-remember representation of a 

function or machine instruction. ) 

Monitor 

The master control program that observes, supervises, 
controls or verifies the operation of a computer system. 
The collection of routines that controls the operation of 
user and system programs, schedules operations, allo- 
cates resources, performs I/O, and so forth. 

Monitor command 

An instruction or command issued directly to a monitor 
from a user. 

Monitor command mode 

The state of the operating system — indicated by a pe- 
riod at the left margin — that allows monitor com- ] 
mands to be entered from the terminal. 
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tyiount a volume 

To logically associate a physical mass storage medium 
with a physical device unit. To place a volume on a 
physical device unit; for example, to place a magtape on 
a magtape drive and put the drive on line. 

Multiprocessing 

Simultaneous execution of two or more computer pro- 
grams by a computer which contains more than one cen- 
tral processor. 

Multiprogramming 

A processing method in which more than one task is in 
an executable state at any one time, even with one CPU. 

Nondirectory-structured 

Refers to a storage volume that is sequential in struc- 
ture and therefore has no volume directory at its begin- 
ning. File information (file name, file type, length, and 
date-of-creation) is provided with each file on the vol- 
ume. Such volumes include magtape and cassette. 

Non-file-structured device 

A device, such as a line printer or terminal, in which 
data cannot be organized as multiple files. 

Object code 

Relocatable machine language code. 
Object module 

The primary output of an assembler or compiler, which 
can be linked with other object modules and loaded into 
memory as a runnable program. The object module is 
composed of the relocatable machine language code, re- 
location information, and the corresponding global sym- 
bol table defining the use of symbols within the module. 

Object Time System (OTS) 

The collection of modules that is called by compiled code 
in order to perform various utility or supervisory opera- 
tions; for example, FORTRAN IV Object Time System. 



Octi 



ODT 



Pertaining to the number system with a radix of eight; 
for example, octal 100 is decimal 64. 



On-line Debugging Technique: an interactive program 
for finding and correcting errors in programs. 

Off-line 

Pertaining to equipment or devices not currently under 
direct control of the computer. 

Glossary-17 



Glossary 

Offset 



The difference between a base location and the location 
of an element related to the base location. The number 
of locations relative to the base of an array, string, or 
block. 

One's complement 

A number formed by interchanging the bit polarities in 
a binary number; for example. Is become Os; Os become 
Is. 

On-line 

Pertaining to equipment or devices directly connected to 
and under control of the computer. 

Op-code (operstion code) 

The part of a machine language instruction that identi- 
fies the operation the CPU is to perform. 

Operand 

The data that an instruction operates upon. An operand 
is usually identified by an address part of an instruction. 

Operating system 

The collection of programs, including a monitor and sys- 
tem programs, that organizes a central processor and 
peripheral devices into a working unit for the develop- 
ment and execution of application programs. 

Operation 

The act specified by a single computer instruction. A 
program step undertaken or executed by a computer; for 
example, addition, multiplication, comparison. The oper- 
ation is usually specified by the operator part of an in- 
struction. 

Operation code 

See Op-code. 

Operator's console 

The set of switches and display lights used by an oper- 
ator or a programmer to determine the status of the 
computer system and to start the computer. 

Option 

An element of a command or command string that en- 
ables the user to select alternatives associated with the 
command. In the RT-11 operating system, an option 
consists of a slash character (/) followed by the option 
name and, optionally, a colon, and an option value. 
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Output 

The result of a process; the transferring of data from 
internal storage to external storage. 

Overflow 

A condition that occurs when a mathematical operation 
yields a result whose magnitude is larger than the hard- 
ware is capable of handling. 

Overlay segment 

A section of code treated as a unit that can overlay code 
already in memory and be overlaid by other overlay seg- 
ments when called from the root segment or another res- 
ident overlay segment. 

Overlay structure 

A program overlay system consisting of a root segment 
and optionally one or more overlay segments. 

Page 

That portion of a text file delimited by form feed charac- 
ters and generally 50 to 60 lines long. Corresponds ap- 
proximately to a physical page of a program listing. 

Parameter 

A variable that is given a constant value for a specific 
purpose or process. 



Parity 



A binary digit appended to an array of binary digits to 
make the sum of all bits always odd or always even. It is 
used to check the validity of data. 



Patch 



PC 

rijr 



To modify a routine in a rough or expedient way, usually 
by modifying the binary code rather than by assembling 
it again. 

See Program counter. 



Programmable data processur. 



Peripheral device 

Any device distinct from the computer that can provide 
input and/or accept output from the computer. 

Physical device 

An I/O or peripheral storage device connected to or asso- 
ciated with a computer. 
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Priority 

A number, associated with a task, that determines the 
order in which the monitor will process the request for 
service by that task, relative to other tasks requesting 
service. 



Process 



A set of related procedures and data that are executed 
and manipulated by a computer. 

Processor 

In hardware, a data processor. In software, a computer 
program that includes the compiler, assembler, trans- 
lator, and related functions for a specific programming 
language (for example, FORTRAN IV processor). 

Processor status word (PSW) 

A register in the PDP-11 that indicates the current pri- 
ority of the processor, the condition of the previous oper- 
ation, and other basic control items. 

Program 

A set of machine instructions or symbolic statements 
combined to perform some task. 

Program counter (PC) 

A register used by the central processor unit to record 
the addresses of the instructions to be executed. The PC 
(register 7 of the eight general registers) always con- 
tains the address of the next instruction to be executed, 
or the second or third word of the current instruction. 

Program development 

The process of writing, entering, translating, and debug- 
ging source programs. 

Programmed request 

A set of instructions (available only to programs) that is 
used to invoke a monitor service. 

Program section 

A named, contiguous unit of code (instructions or data) 
that is considered as an entity and that can be relocated 
separately without destroying the logic of the program. 



Protocol 



A formal set of conventions governing the format and 
relative timing of information exchange between two 
communicating processes. 



Glossary-20 



Glossary 



PSW 

See Processor status word. 

Queue 

Any dynamic list of items; for example, items waiting to 
be scheduled or processed according to system- or user- 
assigned priorities. 

Radix 

The base of a number system; the number of digit sym- 
bols required by a number system. 

RAM (Random-Access Memory) 

Memory that is accessed in such a way that the next 
location from which data is to be obtained is not de- 
pendent on the location of the previously obtained data. 

Random access 

Access to data in which the next location from which 
data is to be obtained is not dependent on the location of 
the previously obtained data. Contrast Sequential ac- 
cess. 

Read-only memory (ROM) 

Memory whose contents are not alterable by computer 
instructions. 

Real-time processing 

The computation performed while a related or controlled 
physical activity is occurring. The results of the compu- 
tation can be used for guiding the process. 

Record 

A collection of related items of data treated as a unit; for 
example, a line of source code or a person's name, rank, 
and serial number. 

Recursive 

Pertaining to a repetitive process in which the result of 
each process is dependent upon the result of the previous 
one. 

Re-entrant 

Pertaining to a program composed of a shareable seg- 
ment of pure code and a nonshareable segment that is 
the data area. 

Register 

See General register. 
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Relative address 



The number that specifies the difference between the 
actual address and a base address. 



Relocate 



In programming, to move a routine from one portion of 
storage to another and to adjust the necessary address 
references so that the routine, in its new location, can be 
executed. 



Resident 



Pertaining to data or instructions that are permanently 
located in main memory. 

Resource 

Any means available to users, such as computational 
power, programs, data files, storage capacity, or a combi- 
nation of these. 

Restart 

To resume execution of a program. 

ROM 

See Read-only memory. 

Root segment 

The segment of an overlay structure that, when loaded, 
remains resident in memory during the execution of a 
program. 

Routine 

A set of instructions arranged in proper sequence to 
cause a computer to perform a desired operation. 

Run 

A single, continuous execution of a program. 

Sector 

A physical portion of a mass storage device. 

Segment 

See Overlay segment. 

Sequential access 

A method of data access in which the next location from 
which data is to be obtained immediately follows the 
location of the previously obtained data. Contrast 
Random access. 
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Software 

The collection of programs and routines associated with 
a computer. Compilers and library routines are exam- 
ples. 

Software bootstrap 

A bootstrap that is activated by loading the instructions 
of the bootstrap and specifying the appropriate load and 
start address. 

Source code 

Text, usually in the form of an ASCII format file, that 
represents a program. Such a file can be processed by an 
appropriate system program. 

Source language 

The system of symbols and syntax used to describe a 
procedure that a computer can execute. 

Spooling 

The technique by which I/O with slow devices is placed 
on mass storage devices to await processing. 

Storage 

Pertaining to a device into which data can be entered, in 
which it can be held, and from which it can be retrieved 
at a later time. 

String 

A connected sequence of entities, such as a line of char- 
acters. 

Subprogram 

A program or a sequence of instructions that can be 
called to perform the same task (though perhaps on dif- 
ferent data) at different points in a program, or in dif- 
ferent programs. 

Subroutine 

See Subprogram. 
Subscript 

■IX XXU.±X±C;XX^ VCiXU.C;VX C;.A.pX CPOOXOXX OX c;.A.^x COOXUXX OXOXXICXXI/ bxxclu 

is appended to a variable name to uniquely identify spe- 
cific elements of an array. Subscripts are enclosed in 
parentheses. There is a subscript for each dimension of 
an array. Multiple subscripts must be separated by 
commas. For example, a two-dimensional subscript 
might be (2,5). 
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Supervisory programs 

Computer programs that have the primary function of 
scheduling, allocating, and controlling system resources. 

Swapping 

The process of moving data from memory to a mass 
storage device, temporarily using the empty memory 
area for another purpose, and then restoring the original 
data to memory. 

Synchronous 

Pertaining to related events where all changes occur si- 
multaneously or in definite timed intervals. 

Syntax 

The structure of expressions in a language and the rules 
governing the structure of a language. 

System program 

A program that performs system-level functions. A pro- 
gram that is part of the basic operating system (for ex- 
ample, a system utility program) is a system program. 

System voiume 

The volume on which the operating system is stored. 

Tabie 

A collection of data in a well-defined list. 

Terminal 

An I/O device, such as an LA120 terminal, that includes 
a keyboard and a display mechanism. In PDP-11 sys- 
tems, a terminal is used as the primary communication 
device between a computer system and a user. 

Time siiaring 

A method of allocating resources to multiple users so 
that the computer processes a number of programs con- 
currently. 

Toggle 

To use switches on the comnuter operator's console to 
enter data into the computer memory. 

Translate 

To convert from one language to another. 

Trap 

A conditional jump to a known memory location per- 
formed automatically by hardware as a side effect of exe- 
cuting a processor instruction. The address location from 
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which the jump occurs is recorded. It is distinguished 
from an interrupt, which is caused by an external event. 

Truncation 

The reduction of precision by ignoring one or more of the 
least significant digits; for example, 3.141597 truncated 
to four decimal digits is 3.141. 

Turnkey 

Pertaining to a computer system sold in a ready-to-use 
state. 

Two's complement 

A number used to represent the negative of a given 
value in many computers. This number is formed from 
the given binary value by changing all Is to Os and all 
Os to Is and then adding 1. 

Underflow 

A condition that occurs when a mathematical operation 
yields a result whose magnitude is smaller than the 
smallest amount the hardware can handle. 

User program 

An application program. 

Utility program 

Any general-purpose program included in an operating 
system to perform common functions. 

Variable 

The symbolic representation of a logical storage location 
that can contain a value that changes during a pro- 
cessing operation. 

Vector 

A consecutive list of associated data. 

Volume 

A mass storage medium that can be used for file-struc- 
tured data storage. 

Wildcard 

A valid substitute for characters in a file specification. 
Used to perform operations on multiple files. Can be as- 
terisks to represent entire file names or file types, or 
percent signs to represent single characters in file 
names or file types. 

Wildcard operation 

A shorthand method of referring to all files with a spe- 
cific characteristic in their name. 
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Word 

Sixteen binary digits treated as a unit in PDP-11 com- 
puter memory. 

Write-enabled 

The condition of a volume that allows information to be 
written on it. 

Write-protected 

The condition of a volume that protects the volume 
against information being written on it. 
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Absolute program sections, 12-4 
Addresses 

assignment by LINK, 12-3 
Advance (A) command (EDIT), 5-9 
Application packages, 1-10 
Assembler, 11-2 
Assembler errors, 11-7 
Assembly language 

See Machine-level language 
Assembly listings, 11-8 
ASSIGN keyboard command 

assigning logical device names, 4^11 

changing the output device, 9-11, 15-5 

Background job 

creating, 15-2 

directing input to, 15-4 

editing, 15-2 

executing, 15-5 

running, 15-2 

terminating, 15-6 
Background program 

running, 15-1 
Backup copy 

files, 17-1 

system volume, B-3 
BASIC-11 

commands, 10-3 to 10-13 

command summary 
edit, 10-6 
execution, 10-11 
file maintenance, 10-13 



demonstration program, 10-7 
errors, 10-9 
running, 10-1 

exiting, 10-3 

immediate mode, 10-3 

interpreter, 10-2 

language processor, 10-1 

programming language, 10-1 
BASIC-11 program 

creating, 10-4, 10-12 

editing, 10-4 

maintaining files, 10-12 

replacing, 10-13 

running, 10-8 

saving, 10-12 

using, 10-12 
BASIC-11 programming language, 1-10, 

8-3 
BASIC keyboard command, 10-2 
BATCH 

stream, 17-1 
Beginning (B) command (EDIT), 5-4 
Bit 

definition of, 11-5 
Bootstrap 

manual operations, A-1 

procedure, 2-4 

prompts and responses (table), 2-6 

pushbutton console, A-1, A-4 

relationship with computer (figure), 
2-2 

suggestions for bootstrapping, B-2 
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Bootstrap (cent.) 

switch register console, A-1, A-5 

terminal keyboard, A-3 

typing, A-3 
Breakpoints 

clearing, 14-9 

clearing all, 14—10 

setting, 14-8 
/BRIEF 

DIRECTORY option, 4-14 
BYE command 

BASIC-11, 10-3 
Byte 

definition of, 11-5 

Character insertion 

immediate mode, 5-17 
Character search (EDIT), 5-9 
Command arguments (EDIT) 

table of, 5-5 
Commands 

BASIC 

See BASIC-11 

control 
format of, 4^3 

correcting typing errors, 4-4 

EDIT 
See EDIT 

keyboard 

See Keyboard commands 
format of, 4-2 

ODT 
See ODT 
Compiler, 9-2 
Computer 

hardware configuration, 2-3 

memory, 2-1 

PDP-11 (figure), 1-3 
Console, 1-4, 3-1 

See also Terminals 
COPY keyboard command, 7-3 
/CREATE 

EDIT option, 5-2 

LIBRARY option, 13-2, 13-5 
CREF table, 11-10 
/CROSSREFERENCE 

MACRO option, 11-7 
Cross-reference (CREF) listing, 11-10 
Cross-reference (CREF) table 

See CREF table 
CTRL/B, 15-4 
CTRL/C CTRL/C 

aborting program execution, 4-14 

returning to BASIC-11 command mode, 
10-9 



terminating background job, 15-6 
terminating indirect file execution, 
16-4 

CTRL/C ESCAPE ESCAPE (EDIT), 5-6, 
5-19 

CTRL/D, 5-19 

CTRL/E, 4-7 

CTRL/F, 15-4 

CTRL/G, 5-18 

CTRL/L, 5-10 

CTRL/N, 5-18 

CTRL/0, 4-12 

CTRL/U, 4-4 

CTRL/U (EDIT), 5-3, 5-8 

CTRL/V, 5-18 

CTRL/X, 5-8 

CTRL key, 3-4 

Date 

See also Time 

displaying, 4-9 

entering, 4-8 
DATE keyboard command, 4-8 
/DEBUG 

LINK option, 14-5 
Debugging a program, 1-9 

See also ODT 

techniques, 14-2 
Decimal/octal/binary conversion, 11-6 
Delete (D) command (EDIT), 5-8 
DELETE (DEL) command 

BASIC-11, 10-5 
DELETE key 

correcting typing errors, 4-4 

editing, 5-3, 5-8 

function, 3-3 

immediate mode, 5-18 

ODT, 14-6 
DELETE keyboard command, 7-6 
Demonstration programs 

BASIC-11, 10-7 

creating, 5-19 

FORTRAN, 5-20 

library files, 13-3 

load maps, 12-8 

MACRO, 5-21 
Device assignments 

changing, 9-11 
Device handlers, 1-8 
Device names, 4-9 
Devices 

random-access, 1-5 

random-access (figure), 1-5 
Device unit, 3-5, 4-10 
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DIFFERENCES keyboard command, 6-2 
DIRECTORY keyboard command, 4-12 
Directory listings, 3-7, 4^12 

generating, 7-1 
Directory-structured volumes, B-4 
Documentation, 1-10 

hardware manuals, 1-10 

software manuals, 1-11 

source listings, 1-11 
Drive 

See Device unit 
DUMP, 1-9 

EDIT 
command arguments (table), 5-5 
commands 

summary of, 5-13 
exiting, 5-19 
EDIT commands, 5-3 to 5-13 
Editing command mode, 5-3 
Editing commands 
ESCAPE 
returning to editing command mode, 
5-19 
Editing commands, multiple 
entering, 5-8 
erasing, 5-8 
EDIT keyboard command 
creating a file, 5-2 
editing a file, 5-4 
Edit lower (EL) command (EDIT), 5-12 
Editors 
EDIT 
See EDIT 
Edit upper (EU) command (EDIT), 5-13 
Errors 
avoiding programming, 14-1 
types of 

assembler, 11-7 
clerical, 14-2 
compiler, 9-4 
logical, 14-2 
syntax, 14-2 
ESC 

See ESCAPE key 
ESCAPE command 
entering multiple commands, 5-8 
returning to editing command mode, 
5-19 
ESCAPE ESCAPE command 
activating immediate mode, 5-17 
executing editing commands, 5-3 
executing multiple editing commands, 
5-8 



ESCAPE key, 3-4, 5-3 
See also ESCAPE command and 
ESCAPE ESCAPE command 
Examples 

re-creating, 4-3 
EXECUTE keyboard command, 9-12, 

11-16 
Exit (EX) command (EDIT), 5-3 

FB monitor, 15-3 
File maintenance 

BASIC-11, 10-12 

programs, 1-9 

See also File maintenance commands 
File maintenance commands 

summary, 7-9 
File maintenance operations, 7-1 
File names, 3-7 

changing, 7-5 
Files 

backup copy, 5-12, 17-1 

closing, 5-3, 5-11 

comparing, 6-1, 6-2 

copying, 7-3 

creating, 5-2 

deleting, 7-5 

editing, 5-4 

editing (figure), 5-2 

indirect 
See Indirect command files 

paging, 5-2 

protecting, 3-7, 7-7 

removing protection from, 7-7 

renaming, 5-6, 7-4 

storing, 3-7 

transferring, 7-3 
File types, 3-7 

changing, 7-5 
File types (table), 4-13 
Foreground/background environment, 

15-1 
Foreground/background monitor 

See FB monitor 
Foreground/background program 

communication, 15-3 
/FOREGROUND/LINK option, 15-4 
Foreground job 

creating, 15-4 

directing input to, 15-4 

executing, 15-5 

linking, 15-4 

loading device handlers, 15-5 

terminating, 15-7 

unloading, 15-7 
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Foreground program 

running, 15-1 
FORLIB.OBJ, 9-3, 12-7 
FORTRAN 

compiler, 9-2 

demonstration program, 5-20 
running, 9-1 

library modules, 9-2 

object time system (OTS), 9-2 

programming language, 1-10, 8-3 
FORTRAN/BASIC language volume, B-5 
FORTRAN demonstration program 

errors, 9-7 
FORTRAN keyboard command, 9-4 
FORTRAN language processor, 9-1 
FORTRAN program 

compiling, 9-3 

execution commands 
summary, 9-14 

linking, 9-8, 9-9, 12-7 

producing a load map, 12-7 

producing a load module, 12-7 

running, 9-11 

sectioning, 12-5 
FORTRAN programming language, 9-1 
FRUN keyboard command, 15-6 

Get (G) command (EDIT), 5-9 
Global symbols, 12-2 
Graphics display terminal 

See VTll display hardware 
GT keyboard command, 4-6 
GT OFF keyboard command, 4-7, 5-2 
GT ON keyboard command, 4-6, 5-16 

Hardware, 1-1 

computer, 1-1 

storage medium, 1-4 

terminal, 1-3 
Hardware configuration, 2-1 

computer, 2-3 

languages, 2-4 

optional devices, 2-4 

storage volume, 2-4 

system volume, 2-3 

terminal, 2-3 
Hardware manuals, 1-10 
HELP file, 17-2 

HELP keyboard command, 17-2 
High-level languages, 1-10, 8-1 

See also BASIC-11 and FORTRAN 

Immediate mode 
BASIC-11, 10-3 



Immediate mode (EDIT) 

character insertion, 5-17 

VTll display hardware, 5-16 
Immediate mode (EDIT) commands, 
5-17 to 5-19 

VTll display hardware (table), 5-17 
Indirect command files, 16-1, 17-1 

creating, 16-1 

entering monitor commands, 16-1 

executing, 16-4 

using, 16-1 

using the editor to create, 16-2 
INITIALIZE keyboard command, 4-15 
Initializing volumes, 4-15 
Input/output devices 

See Peripheral devices 
/INSERT 

LIBRARY option, 13-6 
Insert (I) command (EDIT), 5-3 
Internal symbols, 12-2 
Interpreter 

description of, 10-2 

Jobs 

background, 15-2 

foreground, 15-4 
Jump (J) command (EDIT), 5-7 

Keyboard commands, 4-1 
Keyboard layouts (figure), 3-3 
Keyboard monitor 

See KMON 
Keyboard symbols (table), 4-4 
Kill (K) command (EDIT), 5-9 
KMON, 4-1 

Language comparisons (table), 8-2 
Language processors, 1-10, 8-1 

BASIC-11, 10-1 

FORTRAN, 9-1 

MACRO, 11-2 
Languages 

See Programming languages 
Language volume 

FORTRAN/BASIC, B-5 
Librarian, 1-9 

See also Library files 
Library files 

creating, 13-2 

demonstration programs, 13-3 

macro, 13-1 

maintaining, 13-2 

maintenance commands for 
summary, 13-7 
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Library files (cont.) 

object libraries, 13-1 
LIBRARY keyboard command, 13-2, 

13-5 
Library modules, 9-2 
Library references 

resolving, 12-2 
LINE FEED key, 3-4 

ODT, 14-7 
Linking a program, 1-9 

See also LINK keyboard command and 
Link operation 
LINK keyboard command, 9-9 

linking a foreground program, 15-4 

linking a MACRO program, 11-14 

linking ODT, 14-5 
Link operations, 12-1 

address assignment, 12-3 

overlay feature, 12-6 

producing a load map, 12-7 

producing a load module, 12-7 

program relocation, 12-3 

program sections, 12-4 

resolving library references, 12-2 

resolving symbolic references, 12-2 

summary of commands, 12-11 
Link volume, B-8 
/LIST 

FORTRAN option, 9-4 

LIBRARY option, 13-6 

MACRO option, 11-7 
List (L) command (EDIT), 5-5 
LIST command 

BASIC-11, 10-5 
LISTNH command 

BASIC-11, 10-6 
LOAD keyboard command, 15-5 
Load maps 

demonstration programs, 12-8 

producing, 12-7 
Load modules 

producing, 12-7 
Logical device names 
assigning, 4-9 
special (table), 4-10 
Lowercase characters 
EDIT, 5-12 

Machine language code, 11-4 
Machine-level language, 1-10, 8-1 

See also MACRO 
/MACRO 

LIBRARY option, 13-2 
MACRO 

assembly listing, 11-8 



demonstration program, 5-21 
errors, 11-12 
running, 11-1 

programming language, 8-3, 11-1 
MACRO assembler, 11-2 

running, 11—15 
MACRO keyboard command, 11-7 
MACRO language processor, 11-2 
Macro library files, 13—1 
MACRO programs 

assembling, 11-6 

developing, 11-1 

linking, 11-13, 11-14, 12-7 

producing a load map, 12-7 

producing a load module, 12-7 

sectioning, 12-5 

summary of execution commands, 
11-17 
Macros, 11-11 
/MAP 

LINK option, 12-7 
/MATCH 

DIFFERENCES option, 6-3 
Memory, 2-1, 11-3 
Memory image load module, 11-14 
Monitor 

description of, 1-8 
Monitor command format, 4-2 
Monitor command language 

See Keyboard commands 
Monitor program, 3-1 

NEW command 

BASIC-11, 10-12 
Next (N) command (EDIT), 5-11 
Nondirectory-structured volumes, B-4 

Object libraries, 13-1 

building, 13-2 

creating input files, 13-2 

listing, 13-6 

updating, 13-6 
Object module relocation (figure), 12-4 
Object modules, 12-1 

linking 
FORTRAN, 9-8 
MACRO, 11-13 

linking (figure), 9-9 
Object programs 

linking, 12-1 
Object time system (OTS), 9-2 
ODT, 14-3 

accessing general registers, 14-9 

clearing breakpoints, 14-9 
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ODT (cont.) 

closing the currently open location 
address, 14^7 

commands 
summary, 14^12 

continuing execution, 14^9 

executing MACRO programs, 14-7 

linking with a program, 14-5 

location addresses, 14—7 

opening addressed locations, 14-9 

opening bytes, 14^10 

opening location addresses, 14-7 

opening sequential location addresses, 
14-7 

relocation registers, 14r-7 

removing a breakpoint, 14-9 

removing all breakpoints, 14-10 

running, 14-6 

running a program with, 14-8 

setting breakpoints, 14^-8 

setting relocation registers, 14r-7 
ODT commands, 14-6 to 14-10 
OLD command 

BASIC-11, 10-12 
On-line debugging technique 

See ODT 
Operating system 

applications packages, 1-10 

description of, 1-8 

device handlers, 1-8 

language processors, 1-10 

monitor program, 1-8 

utility programs, 1-8 
Operating system (figure), 1-9 
Optional devices, 1-6 

hardware configuration, 2-4 
Output device 

changing, 9-11, 15-5 
Overlay feature 

See Overlay segments 
Overlay segments, 12-6 

Peripheral devices, 1-6 
Peripheral devices (figure), 1-6 
Physical device names (table), 4r-9 
/PRINTER 

DIRECTORY option, 4-14 
Printer 

enabling, 4-7 
PRINT keyboard command, 7-8 
Processor 

stopping the, B-1 
Program counter, 11-3 
Programmed requests, 11-11 
Programming languages, 8-1 



BASIC-11, 8-3, 10-1 

choosing, 8-1 

comparing (table), 8-2 

DIBOL, 8-3 

FORTRAN, 8-3, 9-1 

hardware configuration, 2-4 

MACRO, 8-3, 11-1 
Program relocation, 12-3 
Programs 

See also FORTRAN program, 

BASIC-11 program, and MACRO 
programs 

debugging, 14r-l 
Program sections 

absolute, 12-4 

blank, 12-5 

instruction, 12-5 

named relocatable, 12-4 
/PROMPT 

LINK option, 12-6 
Prompts 

bootstrap, 2-6 

EDIT, 5-3 

monitor, 4-1 
PROTECT keyboard command, 7-7 
Pushbutton console 

using to bootstrap, A-4 
Pushbutton console (figure), A-4 

/QUERY 

DELETE option, 7-6 

Radix 

conversion table, 11-6 
Random-access devices 

See Devices 
Read (R) command (EDIT), 5-4 
Relocatable program sections, 12-4 
Relocation registers 

ODT, 14-7 
/REMOVE 

LIBRARY option, 13-7 
RENAME keyboard command, 5-6, 7-5 
Renaming files 

cassette users, B-4 

magtape users, B-4 
REPLACE command 

BASIC-11, 10-13 
Resident monitor 

See RMON 
RETURN key 

executing commands, 4-1, 4—3 

function, 3—4 

ODT, 14-7 
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RMON, 4-1 

RT-11 computer system 

description of, 1-1 
RT-11 computer system (figure), 1-2 
RT-11 operating system 

See Operating system 
RUN command 

BASIC-11, 10-8 

ODT, 14-8 
RUN keyboard command 

background job, 15-3 
RUNNH command 

BASIC-11, 10-8 

SAVE command 

BASIC-11, 10-12 
SCRATCH (SCR) command 

BASIC-11, 10-6 
SHIFT key, 3-3 

SHOW keyboard commands, 4—11 
Software 

defined, 1-7 

operating system, 1-8 
Software (figure), 1-8 
Software manuals, 1-11 
Source comparison program, 1-9 

See also Source comparison 
Source files 

comparing, 6-1 
Source listings, 1-11 
Storage medium 

definition of, 1-4 

random-access 

See Devices 

Storage volumes 

hardware configuration, 2-4 

initializing, 4^15 

loading, 2-5 

protecting files, 3-7 

using, 3-4, 3-7 
Storage volumes (figure), 3-6 
SUBSTITUTE (SUB) command 

BASIC-11, 10-4 
Switch register console 

using to bootstrap, A-5 
Switch register console (figure), A-5 
Symbolic references 

resolving, 12-2 
Symbols 

global, 12-2 

internal, 12-2 
Symbol table, 11-4, 11-10 
SYSLIB.OBJ, 9-2, 12-7 
System macro library, 11-11 
System volume, 2-2 

backing up, B-3 



hardware configuration, 2-3 
loading, 2-5 
System volume (table), 2-4 

TAB key, 3-4 
Terminal 

hardware configuration, 2-3 
Terminal (figure), 3-2 
Terminal devices (figure), 1-4 
Terminals, 1-3, 3-1 

console, 1-4 
Text buffer, 5-1 

pointer, 5-4 
Time 

See also Date 

displaying, 4r-9 

entering, 4—8 
TIME keyboard command, 4-8 
TYPE keyboard command, 7-8 

UNLOAD keyboard command, 15-7 
UNPROTECT keyboard command, 7-7 
User service routine 

See USR 
USR, 4-1 
Utility programs, 1-8 

Verify (V) command (EDIT), 5-7 
Volume directory 

file storage, 3-7 

listing, 4-12 

operations, 7—1 
Volume structures 

comparing, B-4 
Volume substitution during operations, 

B-6 
VTll display hardware 

commands, 4-6, 4-7 

enabling, 4-6 

enabling the printer, 4—7 

immediate mode, 5—16 

using, 4-5, 5-15 
VTll display hardware (figure), 4-6 

Wildcards 
using 
with DELETE keyboard command, 

7-6 
with DIRECTORY keyboard 
command, 5—12 
Word 

definition of, 11—5 
Write enable 

file protection, 3-7 
Write protect 
file protection, 3-7 



Index-7 



HOW TO ORDER 
ADDITIONAL DOCUMEIMTATION 



From 



Chicago 



Call 



312-640-5612 

8:15 A.M. to 5:00 p.m. CT 



Write 



Digital Equipment Corporation 
Accessories & Supplies Center 
1050 East Remington Road 
Schaumburg, IL 60195 



San Francisco 
Alaska, Hawaii 



New Hampshire 



Rest of U.S.A., 
Puerto Rico* 



408-734-4915 

8:15 a.m. to 5:00 P.M. PT 

603-884-6660 
8:30 A.M. to 6:00 p.m. ET 

or 408-734^915 

8:15 A.M. to 5:00 p.m. PT 



603-884-6660 
8:30 A.M. to 6:00 p.m. ET 

1-800-258-1710 
8:30 A.M. to 6:00 p.m. ET 



Digital Equipment Corporation 
Accessories & Supplies Center 
632 Caribbean Drive 
Sunnyvale, CA 94086 



Digital Equipment Corporation 
Accessories & Supplies Center 
P.O. Box CS2008 
Nashua, NH 03061 



•Prepaid orders from Puerto Rico must be placed with the local DIGITAL subsidiary (call 809-754-7575) 



Canada 
British Columbia 

Ottawa-Hull 

Elsewhere 



1-800-267-6146 

8:00 A.M. to 5:00 p.m. ET 

613-234-7726 
8:00 A.M. to 5:00 p.m. ET 

112-800-267-6146 

8:00 A.M. to 5:00 p.m. ET 



Digital Equipment of Canada Ltd 
940 Belfast Road 
Ottawa, Ontario K1G 4C2 
Attn: A&SG Business Manager 



Elsewhere 



Digital Equipment Corporation 
A&SG Business Manager* 



*c/o DIGITAL'S local subsidiary or approved distributor 
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